Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/ until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.
Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.
Body
application/json
contentType
enum<string>
required
Type of content to generate.
Available options:
changelog,
blog_post,
linkedin_post,
twitter_post,
image
Example:
"blog_post"
lookbackWindow
enum<string>
default:last_7_days
How far back to collect source activity (commits, pull requests, releases, Linear issues).
Available options:
current_day,
yesterday,
last_7_days,
last_14_days,
last_30_days
Example:
"last_7_days"
brandVoiceId
string
Deprecated. Use brandIdentityId instead.
Minimum string length: 1
Example:
"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561"
brandIdentityId
string | null
Brand identity to write in. Defaults to the organization's default brand identity.
Minimum string length: 1
Example:
"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561"
repositoryIds
string[]
Deprecated. Use integrations.github with GitHub integration IDs instead.
Minimum string length: 1
Example:
["repo_1", "repo_2"]
linearIntegrationIds
string[]
Deprecated. Use integrations.linear with Linear integration IDs instead.
Minimum string length: 1
Example:
["linear_integration_1"]
integrations
object
Source integrations to draw activity from. Omit this and github.repositories to use every connected GitHub integration.
Show child attributes
github
object
Select connected repositories by owner and name instead of integration ID. Cannot be combined with integrations.github.
Which kinds of activity to collect from the selected sources. At least one must be true, unless pullRequest is set, which ignores them.
Show child attributes
selectedItems
object
Restrict generation to specific commits, pull requests, releases, or Linear issues instead of everything in the lookback window.
Show child attributes
timezone
string
IANA timezone used for relative lookback windows such as current_day and yesterday.
Required string length: 1 - 100
Example:
"America/New_York"
pullRequest
object
Write about exactly this pull request in a connected repository, open or merged, whatever its age. Uses only its pull request data, so dataPoints and lookbackWindow do not apply. Cannot be combined with other source selectors or selectedItems.
What the post should be about and what it should cover, in your own words. Steers the topic, angle and structure; facts still come from the selected sources.
Required string length: 1 - 4000
Example:
"Announce mention-driven blog posts. Lead with the phone workflow and show the comment that triggers it."
Response
Post generation queued successfully
organization
object
required
Show child attributes
job
object
required
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Notra Documentation","description":"Documentation for Notra: track your brand across AI answer engines and turn your team's work into content.","colors":{"primary":"#8b5cf6","light":"#8b5cf6","dark":"#8b5cf6"},"logo":{"light":"https://mintcdn.com/notra/2ET3yj_w1EiaVUnN/logo/notra-wordmark.svg?fit=max\u0026auto=format\u0026n=2ET3yj_w1EiaVUnN\u0026q=85\u0026s=ec067541de0d7eb5eb2bddf6eed3e9b4","dark":"https://mintcdn.com/notra/2ET3yj_w1EiaVUnN/logo/notra-wordmark-dark.svg?fit=max\u0026auto=format\u0026n=2ET3yj_w1EiaVUnN\u0026q=85\u0026s=acc35d633060260aca265100d13e09a1"},"favicon":"https://mintcdn.com/notra/KRbWPF6cEiTVNBm6/favicon.svg?fit=max\u0026auto=format\u0026n=KRbWPF6cEiTVNBm6\u0026q=85\u0026s=ff71fb69837d03de53146d96aad9402a","api":{"url":"full"},"appearance":{"default":"light"},"navbar":{"links":[{"href":"https://www.usenotra.com/discord","label":"Discord"},{"href":"https://github.com/usenotra","type":"github"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.usenotra.com"}},"footer":{"socials":{"x":"https://x.com/usenotra","github":"https://github.com/usenotra","discord":"https://www.usenotra.com/discord"}},"search":{"prompt":"Search the Notra docs..."},"seo":{"metatags":{"twitter:site":"@usenotra"}},"styling":{"eyebrows":"breadcrumbs","codeblocks":"system","latex":true},"errors":{"404":{"redirect":false,"title":"This page is on a content pipeline of its own","description":"Looks like this page hasn't shipped yet. Try the [quickstart](/quickstart) or the [product map](/geo/product-map)."}},"contextual":{"options":["copy","view","assistant","mcp","chatgpt","claude","cursor"],"display":"header"},"thumbnails":{"preset":"headline"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"notra","hasAudioNarration":false,"actualSubdomain":"notra","customDomains":["www.usenotra.com"],"gitSource":{"type":"github","owner":"usenotra","repo":"notra","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":false,"agentFeedback":true,"issues":false},"entitlements":{},"buildId":"6afc09d6f1815dc4b12efc4e","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Developers","count":175},{"language":"default","tag":"Endpoints","count":158},{"language":"default","tag":"GEO","count":105},{"language":"default","tag":"Sites","count":67},{"language":"default","tag":"Analytics","count":32},{"language":"default","tag":"Integrations","count":23},{"language":"default","tag":"Posts","count":16},{"language":"default","tag":"AI Traffic","count":15},{"language":"default","tag":"Studio","count":15},{"language":"default","tag":"Domains","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"buttons.css","content":".notra-button,#topbar-cta-button>a{--notra-button-shadow: 0 0 transparent;display:inline-flex;align-items:center;justify-content:center;gap:0.375rem;height:2rem;padding:0 0.625rem;border:1px solid transparent;border-radius:0.5rem;font-size:0.875rem;font-weight:500;line-height:1;text-decoration:none;white-space:nowrap;cursor:pointer;box-shadow:var(--notra-button-shadow);transition:background-color 150ms ease-out,\n filter 150ms ease-out,\n transform 150ms ease-out}.notra-button-primary,#topbar-cta-button>a{color:oklch(0.997 0 0);border-color:oklch(0.6056 0.2189 292.7172 / 60%);background:linear-gradient(\n 180deg,\n oklch(0.6056 0.2189 292.7172 / 85%),\n oklch(0.6056 0.2189 292.7172)\n );--notra-button-shadow:\n inset 0 1px 0 rgb(255 255 255 / 28%), 0 1px 2px rgb(0 0 0 / 18%)}.notra-button-primary:hover,#topbar-cta-button>a:hover{filter:brightness(1.1)}.notra-button-outline{color:hsl(0 0% 9%);border-color:hsl(0 0% 89.8%);background:hsl(0 0% 100%);--notra-button-shadow: 0 1px 2px rgb(0 0 0 / 5%)}.notra-button-outline:hover{background:hsl(0 0% 96.1%)}.dark .notra-button-outline{color:hsl(0 0% 98%);border-color:hsl(240 4% 20%);background:hsl(240 4% 20% / 30%);--notra-button-shadow: 0 0 transparent}.dark .notra-button-outline:hover{background:hsl(240 4% 20% / 50%)}@supports (corner-shape: squircle){.notra-button,#topbar-cta-button>a{corner-shape:squircle;border-radius:0.75rem}}#topbar-cta-button>a>span{background:transparent}.notra-button:focus-visible,#topbar-cta-button>a:focus-visible{outline:none;border-color:oklch(0.6056 0.2189 292.7172);box-shadow:0 0 0 3px oklch(0.6056 0.2189 292.7172 / 50%),\n var(--notra-button-shadow)}.notra-button:active:not(:disabled),#topbar-cta-button>a:active{transform:scale(0.97)}.notra-button:disabled{cursor:not-allowed;opacity:0.5}@media (prefers-reduced-motion: reduce){.notra-button,#topbar-cta-button>a{transition:none}.notra-button:active:not(:disabled),#topbar-cta-button>a:active{transform:none}}"},{"filePath":"card-icons.css","content":"html.dark [data-component-part=\"card-icon\"] img[src*=\"/images/integrations/posthog.svg\"]{content:url(\"/images/integrations/posthog-dark.svg\")}"},{"filePath":"theme.css","content":"[role=\"menu\"]:has([data-component-part=\"theme-preference-menu-item\"]){opacity:0;pointer-events:none}"}],"page":{"pagePath":"api-reference/content/queue-async-post-generation","slug":"/api-reference/content/queue-async-post-generation","pageMetadata":{"title":"Queue async post generation","description":"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/generate","href":"/api-reference/content/queue-async-post-generation","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/\", \" until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Queue async post generation","description":"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/generate","href":"/api-reference/content/queue-async-post-generation","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/notra/1c34b1755a71d50d/databuddy.js","/docs/_mintlify/custom/notra/5641b035830c1390/theme-toggle.js"],"openApiReferenceData":{"operation":{"tags":["Content"],"operationId":"createPostGeneration","summary":"Queue async post generation","description":"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.","requestBody":"0cdb2c91-160d-4dda-807f-f6a3754fce55","responses":{"202":"3a6ba305-78e1-481d-a6bb-3522647c1698","400":"ad6daea7-4cf3-4bdc-9df6-dc6c529e4516","401":"968d1864-f6da-4485-8f66-e7f542b68771","403":"2e36c6e2-16ab-4779-a446-f11e13234c36","404":"676b541d-017c-4a50-aeb1-d0a2d39005b5","429":"37f173eb-9f7d-42eb-bcee-5c3f49c5f45f","503":"125d8539-efb7-4c1f-9ecf-e11dabbc0121"},"method":"post","type":"path","servers":["daeaeef0-4c24-4af4-84c6-fc72134e8ccc","d14ea173-1e2b-43f3-b5f0-fb6eb6c995ee"],"security":["73e88a5d-d79d-419a-9f77-174ce54cb815"],"path":"/v1/posts/generate","baseUrlOptions":["https://api.usenotra.com","https://demo-api.usenotra.com"],"title":"Queue async post generation","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"contentType":{"type":"string","enum":["changelog","blog_post","linkedin_post","twitter_post","image"],"description":"Type of content to generate.","example":"blog_post","isRequired":true,"uniqueKey":"contentType","typeLabel":"enum\u003cstring>"},"lookbackWindow":{"type":"string","enum":["current_day","yesterday","last_7_days","last_14_days","last_30_days"],"default":"last_7_days","description":"How far back to collect source activity (commits, pull requests, releases, Linear issues).","example":"last_7_days","uniqueKey":"lookbackWindow","typeLabel":"enum\u003cstring>"},"brandVoiceId":{"type":"string","minLength":1,"description":"Deprecated. Use brandIdentityId instead.","example":"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561","uniqueKey":"brandVoiceId","typeLabel":"string"},"brandIdentityId":{"oneOf":[{"type":"string","minLength":1,"description":"Brand identity to write in. Defaults to the organization's default brand identity.","example":"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561","uniqueKey":"brandIdentityId.oneOf.0","typeLabel":"string"},{"type":"null","minLength":1,"description":"Brand identity to write in. Defaults to the organization's default brand identity.","example":"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561","uniqueKey":"brandIdentityId.oneOf.1","typeLabel":"null"}],"uniqueKey":"brandIdentityId","typeLabel":"string | null"},"repositoryIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"repositoryIds.items.[INDEX]","typeLabel":"string"},"example":["repo_1","repo_2"],"description":"Deprecated. Use integrations.github with GitHub integration IDs instead.","uniqueKey":"repositoryIds","typeLabel":"string[]"},"linearIntegrationIds":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"linearIntegrationIds.items.[INDEX]","typeLabel":"string"},"example":["linear_integration_1"],"description":"Deprecated. Use integrations.linear with Linear integration IDs instead.","uniqueKey":"linearIntegrationIds","typeLabel":"string[]"},"integrations":{"type":"object","properties":{"github":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"integrations.github.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"GitHub integration IDs to use as sources, as returned by GET /v1/integrations.","example":["integration_1","integration_2"],"uniqueKey":"integrations.github","typeLabel":"string[]"},"linear":{"type":"array","items":{"type":"string","minLength":1,"uniqueKey":"integrations.linear.items.[INDEX]","typeLabel":"string"},"minItems":1,"description":"Linear integration IDs to use as sources, as returned by GET /v1/integrations.","example":["linear_integration_1"],"uniqueKey":"integrations.linear","typeLabel":"string[]"}},"description":"Source integrations to draw activity from. Omit this and github.repositories to use every connected GitHub integration.","uniqueKey":"integrations","typeLabel":"object"},"github":{"type":"object","properties":{"repositories":{"type":"array","items":{"type":"object","properties":{"owner":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"github.repositories.items.[INDEX].owner","typeLabel":"string"},"repo":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"github.repositories.items.[INDEX].repo","typeLabel":"string"}},"required":["owner","repo"],"uniqueKey":"github.repositories.items.[INDEX]","typeLabel":"object"},"minItems":1,"isRequired":true,"uniqueKey":"github.repositories","typeLabel":"object[]"}},"required":["repositories"],"description":"Select connected repositories by owner and name instead of integration ID. Cannot be combined with integrations.github.","example":{"repositories":[{"owner":"usenotra","repo":"notra"}]},"uniqueKey":"github","typeLabel":"object"},"dataPoints":{"type":"object","properties":{"includePullRequests":{"type":"boolean","default":true,"uniqueKey":"dataPoints.includePullRequests","typeLabel":"boolean"},"includeCommits":{"type":"boolean","default":true,"uniqueKey":"dataPoints.includeCommits","typeLabel":"boolean"},"includeReleases":{"type":"boolean","default":true,"uniqueKey":"dataPoints.includeReleases","typeLabel":"boolean"},"includeLinearData":{"type":"boolean","default":false,"uniqueKey":"dataPoints.includeLinearData","typeLabel":"boolean"}},"default":{"includePullRequests":true,"includeCommits":true,"includeReleases":true,"includeLinearData":false},"description":"Which kinds of activity to collect from the selected sources. At least one must be true, unless pullRequest is set, which ignores them.","uniqueKey":"dataPoints","typeLabel":"object"},"selectedItems":{"type":"object","properties":{"commitShas":{"type":"array","items":{"type":"string","uniqueKey":"selectedItems.commitShas.items.[INDEX]","typeLabel":"string"},"uniqueKey":"selectedItems.commitShas","typeLabel":"string[]"},"pullRequestNumbers":{"type":"array","items":{"type":"object","properties":{"repositoryId":{"type":"string","isRequired":true,"uniqueKey":"selectedItems.pullRequestNumbers.items.[INDEX].repositoryId","typeLabel":"string"},"number":{"type":"number","isRequired":true,"uniqueKey":"selectedItems.pullRequestNumbers.items.[INDEX].number","typeLabel":"number"}},"required":["repositoryId","number"],"uniqueKey":"selectedItems.pullRequestNumbers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"selectedItems.pullRequestNumbers","typeLabel":"object[]"},"releaseTagNames":{"type":"array","items":{"oneOf":[{"type":"string","uniqueKey":"selectedItems.releaseTagNames.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"object","required":["repositoryId","tagName"],"properties":{"repositoryId":{"type":"string","isRequired":true,"uniqueKey":"selectedItems.releaseTagNames.items.[INDEX].oneOf.1.repositoryId","typeLabel":"string"},"tagName":{"type":"string","isRequired":true,"uniqueKey":"selectedItems.releaseTagNames.items.[INDEX].oneOf.1.tagName","typeLabel":"string"}},"uniqueKey":"selectedItems.releaseTagNames.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"selectedItems.releaseTagNames.items.[INDEX]","typeLabel":"string | object"},"uniqueKey":"selectedItems.releaseTagNames","typeLabel":"(string | object)[]"},"linearIssueIds":{"type":"array","items":{"type":"object","properties":{"integrationId":{"type":"string","isRequired":true,"uniqueKey":"selectedItems.linearIssueIds.items.[INDEX].integrationId","typeLabel":"string"},"issueId":{"type":"string","isRequired":true,"uniqueKey":"selectedItems.linearIssueIds.items.[INDEX].issueId","typeLabel":"string"}},"required":["integrationId","issueId"],"uniqueKey":"selectedItems.linearIssueIds.items.[INDEX]","typeLabel":"object"},"uniqueKey":"selectedItems.linearIssueIds","typeLabel":"object[]"}},"description":"Restrict generation to specific commits, pull requests, releases, or Linear issues instead of everything in the lookback window.","uniqueKey":"selectedItems","typeLabel":"object"},"timezone":{"type":"string","minLength":1,"maxLength":100,"description":"IANA timezone used for relative lookback windows such as current_day and yesterday.","example":"America/New_York","uniqueKey":"timezone","typeLabel":"string"},"pullRequest":{"type":"object","properties":{"owner":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"pullRequest.owner","typeLabel":"string"},"repo":{"type":"string","minLength":1,"isRequired":true,"uniqueKey":"pullRequest.repo","typeLabel":"string"},"number":{"type":"integer","exclusiveMinimum":0,"isRequired":true,"uniqueKey":"pullRequest.number","typeLabel":"integer"}},"required":["owner","repo","number"],"description":"Write about exactly this pull request in a connected repository, open or merged, whatever its age. Uses only its pull request data, so dataPoints and lookbackWindow do not apply. Cannot be combined with other source selectors or selectedItems.","example":{"owner":"usenotra","repo":"notra","number":2385},"uniqueKey":"pullRequest","typeLabel":"object"},"brief":{"type":"string","minLength":1,"maxLength":4000,"description":"What the post should be about and what it should cover, in your own words. Steers the topic, angle and structure; facts still come from the selected sources.","example":"Announce mention-driven blog posts. Lead with the phone workflow and show the comment that triggers it.","uniqueKey":"brief","typeLabel":"string"}},"required":["contentType"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"contentType":"blog_post","lookbackWindow":"last_7_days","brandVoiceId":"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561","brandIdentityId":"51c2f3aa-efdd-4e28-8e69-23fa2dfd3561","repositoryIds":["repo_1","repo_2"],"linearIntegrationIds":["linear_integration_1"],"integrations":{"github":["integration_1","integration_2"],"linear":["linear_integration_1"]},"github":{"repositories":[{"owner":"usenotra","repo":"notra"}]},"dataPoints":{"includePullRequests":true,"includeCommits":true,"includeReleases":true,"includeLinearData":false},"selectedItems":{"commitShas":["\u003cstring>"],"pullRequestNumbers":[{"repositoryId":"\u003cstring>","number":123}],"releaseTagNames":["\u003cstring>"],"linearIssueIds":[{"integrationId":"\u003cstring>","issueId":"\u003cstring>"}]},"timezone":"America/New_York","pullRequest":{"owner":"usenotra","repo":"notra","number":2385},"brief":"Announce mention-driven blog posts. Lead with the phone workflow and show the comment that triggers it."}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"3a6ba305-78e1-481d-a6bb-3522647c1698":{"description":"Post generation queued successfully","content":{"application/json":{"schema":{"type":"object","properties":{"organization":{"type":"object","properties":{"id":{"type":"string","description":"Workspace ID. Account API keys can send it, or the slug, as X-Notra-Organization-Id.","isRequired":true,"uniqueKey":"organization.id","typeLabel":"string"},"slug":{"type":"string","isRequired":true,"uniqueKey":"organization.slug","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"organization.name","typeLabel":"string"},"logo":{"oneOf":[{"type":"string","description":"Workspace logo image URL. Null when none is set.","isRequired":true,"uniqueKey":"organization.logo.oneOf.0","typeLabel":"string"},{"type":"null","description":"Workspace logo image URL. Null when none is set.","isRequired":true,"uniqueKey":"organization.logo.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"organization.logo","typeLabel":"string | null"}},"required":["id","slug","name","logo"],"isRequired":true,"uniqueKey":"organization","typeLabel":"object"},"job":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"job.id","typeLabel":"string"},"organizationId":{"type":"string","isRequired":true,"uniqueKey":"job.organizationId","typeLabel":"string"},"status":{"type":"string","enum":["queued","running","completed","failed","skipped"],"description":"Job state. Terminal states are completed, failed, and skipped.","isRequired":true,"uniqueKey":"job.status","typeLabel":"enum\u003cstring>"},"contentType":{"type":"string","enum":["changelog","blog_post","linkedin_post","twitter_post","image"],"isRequired":true,"uniqueKey":"job.contentType","typeLabel":"enum\u003cstring>"},"lookbackWindow":{"type":"string","enum":["current_day","yesterday","last_7_days","last_14_days","last_30_days"],"isRequired":true,"uniqueKey":"job.lookbackWindow","typeLabel":"enum\u003cstring>"},"repositoryIds":{"type":"array","items":{"type":"string","uniqueKey":"job.repositoryIds.items.[INDEX]","typeLabel":"string"},"description":"Selected GitHub integration IDs. Empty when no GitHub source was selected. Every connected GitHub integration is used only when neither a GitHub nor a Linear source was selected.","isRequired":true,"uniqueKey":"job.repositoryIds","typeLabel":"string[]"},"brandVoiceId":{"oneOf":[{"type":"string","description":"Brand identity the post is written in: the requested one, else the default, else the most recently updated. Null when the organization has none.","isRequired":true,"uniqueKey":"job.brandVoiceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Brand identity the post is written in: the requested one, else the default, else the most recently updated. Null when the organization has none.","isRequired":true,"uniqueKey":"job.brandVoiceId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job.brandVoiceId","typeLabel":"string | null"},"workflowRunId":{"oneOf":[{"type":"string","description":"Internal workflow run ID. Null until the generation workflow has started.","isRequired":true,"uniqueKey":"job.workflowRunId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Internal workflow run ID. Null until the generation workflow has started.","isRequired":true,"uniqueKey":"job.workflowRunId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job.workflowRunId","typeLabel":"string | null"},"postId":{"oneOf":[{"type":"string","description":"ID of the generated post. Set once the job reaches completed.","isRequired":true,"uniqueKey":"job.postId.oneOf.0","typeLabel":"string"},{"type":"null","description":"ID of the generated post. Set once the job reaches completed.","isRequired":true,"uniqueKey":"job.postId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job.postId","typeLabel":"string | null"},"error":{"oneOf":[{"type":"string","description":"Failure reason when status is failed, or why generation was skipped (for example no meaningful source activity) when status is skipped.","isRequired":true,"uniqueKey":"job.error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Failure reason when status is failed, or why generation was skipped (for example no meaningful source activity) when status is skipped.","isRequired":true,"uniqueKey":"job.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job.error","typeLabel":"string | null"},"source":{"type":"string","enum":["api","dashboard"],"description":"Where the job was started.","isRequired":true,"uniqueKey":"job.source","typeLabel":"enum\u003cstring>"},"createdAt":{"type":"string","isRequired":true,"uniqueKey":"job.createdAt","typeLabel":"string"},"updatedAt":{"type":"string","isRequired":true,"uniqueKey":"job.updatedAt","typeLabel":"string"},"completedAt":{"oneOf":[{"type":"string","description":"When the job reached completed, failed or skipped. Null while it is queued or running.","isRequired":true,"uniqueKey":"job.completedAt.oneOf.0","typeLabel":"string"},{"type":"null","description":"When the job reached completed, failed or skipped. Null while it is queued or running.","isRequired":true,"uniqueKey":"job.completedAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"job.completedAt","typeLabel":"string | null"},"errorCode":{"oneOf":[{"type":"string","description":"Stable machine-readable failure code when status is failed, such as NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES. Absent or null for other failures and for older jobs.","example":"NO_AVAILABLE_SOURCES","uniqueKey":"job.errorCode.oneOf.0","typeLabel":"string"},{"type":"null","description":"Stable machine-readable failure code when status is failed, such as NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES. Absent or null for other failures and for older jobs.","example":"NO_AVAILABLE_SOURCES","uniqueKey":"job.errorCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"job.errorCode","typeLabel":"string | null"}},"required":["id","organizationId","status","contentType","lookbackWindow","repositoryIds","brandVoiceId","workflowRunId","postId","error","source","createdAt","updatedAt","completedAt"],"isRequired":true,"uniqueKey":"job","typeLabel":"object"}},"required":["organization","job"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"organization":{"id":"\u003cstring>","slug":"\u003cstring>","name":"\u003cstring>","logo":"\u003cstring>"},"job":{"id":"\u003cstring>","organizationId":"\u003cstring>","status":"queued","contentType":"changelog","lookbackWindow":"current_day","repositoryIds":["\u003cstring>"],"brandVoiceId":"\u003cstring>","workflowRunId":"\u003cstring>","postId":"\u003cstring>","error":"\u003cstring>","source":"api","createdAt":"\u003cstring>","updatedAt":"\u003cstring>","completedAt":"\u003cstring>","errorCode":"NO_AVAILABLE_SOURCES"}}}},"exampleType":"generated"}},"exampleType":"generated"},"ad6daea7-4cf3-4bdc-9df6-dc6c529e4516":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"968d1864-f6da-4485-8f66-e7f542b68771":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2e36c6e2-16ab-4779-a446-f11e13234c36":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"676b541d-017c-4a50-aeb1-d0a2d39005b5":{"description":"Organization not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"recovery":{"type":"string","uniqueKey":"recovery","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>","recovery":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"37f173eb-9f7d-42eb-bcee-5c3f49c5f45f":{"description":"Rate limit exceeded. This endpoint allows 10 requests per 1 minute per API key.","headers":{"RateLimit-Limit":{"description":"Maximum requests allowed in the current window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requests remaining in the current window.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Seconds until the current window resets.","schema":{"type":"integer"}},"Retry-After":{"description":"Seconds the client should wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"limit":{"type":"integer","minimum":1,"description":"Requests allowed per window.","isRequired":true,"uniqueKey":"limit","typeLabel":"integer"},"remaining":{"type":"integer","minimum":0,"description":"Requests left in the current window.","isRequired":true,"uniqueKey":"remaining","typeLabel":"integer"},"reset":{"type":"integer","description":"When the window resets, as a Unix timestamp in milliseconds. Retry-After gives the wait in seconds.","isRequired":true,"uniqueKey":"reset","typeLabel":"integer"}},"required":["error","limit","remaining","reset"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","limit":2,"remaining":1,"reset":123}}},"exampleType":"generated"}},"exampleType":"generated"},"125d8539-efb7-4c1f-9ecf-e11dabbc0121":{"description":"Content generation is unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"jobId":{"type":"string","uniqueKey":"jobId","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","jobId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"73e88a5d-d79d-419a-9f77-174ce54cb815":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"daeaeef0-4c24-4af4-84c6-fc72134e8ccc":{"url":"https://api.usenotra.com","description":"Production"},"d14ea173-1e2b-43f3-b5f0-fb6eb6c995ee":{"url":"https://demo-api.usenotra.com","description":"Sandbox with sample data. Get a free sandbox key at demo.usenotra.com, no signup needed"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.usenotra.com/openapi.json"},"subdomain":"notra","siteName":"Notra Documentation","title":"Queue async post generation - Notra Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/content/queue-async-post-generation.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Notra Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Queue async post generation - Notra Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Notra Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://notra.mintlify.site/docs/_mintlify/api/og/v2?division=Generation\u0026amp;title=Queue+async+post+generation\u0026amp;description=Queues+a+generation+job+for+one+content+type+and+returns+202+with+the+job.+Select+sources+with+integrations.github%2C+integrations.linear%2C+or+github.repositories%3B\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=420f3c902cb1677bb955a2fba12b2cd8d8a91eb4345170739a91a219c791cf52\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Queue async post generation - Notra Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://notra.mintlify.site/docs/_mintlify/api/og/v2?division=Generation\u0026amp;title=Queue+async+post+generation\u0026amp;description=Queues+a+generation+job+for+one+content+type+and+returns+202+with+the+job.+Select+sources+with+integrations.github%2C+integrations.linear%2C+or+github.repositories%3B\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=420f3c902cb1677bb955a2fba12b2cd8d8a91eb4345170739a91a219c791cf52\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/notra/sxLIY7EtkqgtHg_V/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Notra Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8b5cf6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/content/queue-async-post-generation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.usenotra.com/#organization\",\"name\":\"Notra Documentation\",\"url\":\"https://www.usenotra.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/notra/2ET3yj_w1EiaVUnN/logo/notra-wordmark.svg?fit=max\u0026auto=format\u0026n=2ET3yj_w1EiaVUnN\u0026q=85\u0026s=ec067541de0d7eb5eb2bddf6eed3e9b4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.usenotra.com/docs#website\",\"name\":\"Notra Documentation\",\"url\":\"https://www.usenotra.com/docs\",\"publisher\":{\"@id\":\"https://www.usenotra.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation#webpage\",\"url\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation\",\"name\":\"Queue async post generation\",\"description\":\"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.\",\"isPartOf\":{\"@id\":\"https://www.usenotra.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://www.usenotra.com/docs/api-reference/discovery/check-public-api-reachability\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Posts\",\"item\":\"https://www.usenotra.com/docs/api-reference/content/list-posts\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Queue async post generation\",\"item\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation#apireference\",\"headline\":\"Queue async post generation\",\"name\":\"Queue async post generation\",\"description\":\"Queues a generation job for one content type and returns 202 with the job. Select sources with integrations.github, integrations.linear, or github.repositories; when no selector is given at all, every connected GitHub integration is used. Pass pullRequest to write about one pull request, and brief to say what the post should cover. Requests with every dataPoints flag false, or with no usable source, are rejected with 400 and code NO_ACTIVITY_TYPES_SELECTED or NO_AVAILABLE_SOURCES before a job is created. Poll GET /v1/posts/generate/{jobId} until job.status is completed, failed, or skipped. Subscribe to post.generation.completed, post.generation.failed, or post.generation.skipped using /v1/webhooks for completion notifications.\",\"url\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation\",\"mainEntityOfPage\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/content/queue-async-post-generation#webpage\"},\"publisher\":{\"@id\":\"https://www.usenotra.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.usenotra.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Notra Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Notra Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/content/queue-async-post-generation.md","siteName":"Notra Documentation","nav":{"global":null,"tabs":[{"tab":"GEO","icon":"chart-line","pages":[{"title":"GEO","href":"/quickstart"}]},{"tab":"Sites","icon":"globe","pages":[{"title":"Sites","href":"/sites/overview"}]},{"tab":"Analytics","icon":"robot","pages":[{"title":"Analytics","href":"/analytics/overview"}]},{"tab":"Playbooks","icon":"book-open","pages":[{"title":"Playbooks","href":"/playbooks/first-30-days"}]},{"tab":"Studio","icon":"pen-nib","pages":[{"title":"Studio","href":"/concepts/content-pipeline"}]},{"tab":"Developers","icon":"code","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Getting started","href":"/api/getting-started"},{"title":"Authentication","href":"/api/authentication"},{"title":"Rate limits","href":"/api/rate-limits"},{"title":"Versioning and deprecation","href":"/api/versioning"}]},{"group":"Developer Tools","icon":"terminal","pages":[{"title":"CLI","href":"/devtools/cli"},{"title":"MCP server","href":"/devtools/mcp"},{"title":"Claude Connector","href":"/devtools/claude"},{"title":"ChatGPT Plugin","href":"/devtools/chatgpt"},{"title":"Composio Toolkit","href":"/devtools/composio"},{"title":"Raycast Extension","href":"/devtools/raycast"}]},{"group":"Guides","icon":"book-open","pages":[{"title":"Caching","href":"/api/caching"},{"title":"Common tasks","href":"/api/common-tasks"},{"title":"Pagination","href":"/api/pagination"},{"title":"TypeScript types","href":"/api/types"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks overview","href":"/api/webhooks/overview"},{"title":"Webhook events","href":"/api/webhooks/events"},{"title":"Outbound webhooks","href":"/api/webhooks/outbound"}]},{"group":"Endpoints","icon":"server","expanded":true,"pages":[{"group":"Discovery","expanded":true,"pages":[{"title":"Check public API reachability","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/status","href":"/api-reference/discovery/check-public-api-reachability"},{"title":"Get authenticated workspace context","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/me/workspaces","href":"/api-reference/discovery/get-authenticated-workspace-context"}]},{"group":"Posts","expanded":true,"pages":[{"title":"List posts","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts","href":"/api-reference/content/list-posts"},{"title":"Create a post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts","href":"/api-reference/content/create-a-post"},{"title":"Get a single post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/{postId}","href":"/api-reference/content/get-a-single-post"},{"title":"Update a single post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/posts/{postId}","href":"/api-reference/content/update-a-single-post"},{"title":"Delete a single post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/posts/{postId}","href":"/api-reference/content/delete-a-single-post"},{"title":"Get a post's agent reach","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/{postId}/agent-reach","href":"/api-reference/content/get-a-posts-agent-reach"},{"title":"Open a draft pull request for a post","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/{postId}/pull-request","href":"/api-reference/content/open-a-draft-pull-request-for-a-post"},{"title":"List post authors","description":"Returns the organization's authors, sorted by name. Authors are created in the dashboard; pass their IDs in metadata.authorIds when updating a blog post or changelog. Blog posts on a Notra Sites site can also use that site's own authors from GET /v1/sites/{siteId}/authors.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/authors","href":"/api-reference/content/list-post-authors"},{"group":"Generation","expanded":true,"pages":[{"title":"Queue async post generation","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/generate","href":"/api-reference/content/queue-async-post-generation"},{"title":"Get async post generation status","description":"Returns the job and its event log. job.status moves from queued to running and ends as completed, failed, or skipped. job.postId is set once the post has been created; fetch it with GET /v1/posts/{postId}.","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/generate/{jobId}","href":"/api-reference/content/get-async-post-generation-status"}]},{"group":"Scheduling","expanded":true,"pages":[{"title":"Get a post's publishing schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/posts/{postId}/schedule","href":"/api-reference/content/get-a-posts-publishing-schedule"},{"title":"Schedule a post for publishing","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/posts/{postId}/schedule","href":"/api-reference/content/schedule-a-post-for-publishing"},{"title":"Cancel a post's publishing schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/posts/{postId}/schedule","href":"/api-reference/content/cancel-a-posts-publishing-schedule"}]}]},{"group":"Sites","expanded":true,"pages":[{"title":"List Notra Sites","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites","href":"/api-reference/sites/list-notra-sites"},{"title":"Get a Site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}","href":"/api-reference/sites/get-a-site"},{"group":"Deployments","expanded":true,"pages":[{"title":"List a Site's deployments","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/deployments","href":"/api-reference/sites/list-a-sites-deployments"},{"title":"Deploy the production branch","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/deployments","href":"/api-reference/sites/deploy-the-production-branch"},{"title":"Get a deployment and its build log","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/deployments/{deploymentId}","href":"/api-reference/sites/get-a-deployment-and-its-build-log"},{"title":"Rebuild a deployment","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/deployments/{deploymentId}/redeploy","href":"/api-reference/sites/rebuild-a-deployment"}]},{"group":"Posts","expanded":true,"pages":[{"title":"Preview a post on a Site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/post-previews","href":"/api-reference/sites/preview-a-post-on-a-site"},{"title":"Get a post preview","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/post-previews/{postId}","href":"/api-reference/sites/get-a-post-preview"},{"title":"Publish a post to a Site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/publications","href":"/api-reference/sites/publish-a-post-to-a-site"}]},{"group":"Authors and Design","expanded":true,"pages":[{"title":"List a site's authors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/sites/{siteId}/authors","href":"/api-reference/sites/list-a-sites-authors"},{"title":"Create or update a site author","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json put /v1/sites/{siteId}/authors/{authorId}","href":"/api-reference/sites/create-or-update-a-site-author"},{"title":"Delete a site author","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/sites/{siteId}/authors/{authorId}","href":"/api-reference/sites/delete-a-site-author"},{"title":"Import Notra authors into a site","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/authors/import","href":"/api-reference/sites/import-notra-authors-into-a-site"},{"title":"Set the author page layout","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/sites/{siteId}/author-page","href":"/api-reference/sites/set-the-author-page-layout"},{"title":"Set the blog and changelog paths","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/sites/{siteId}/sections","href":"/api-reference/sites/set-the-blog-and-changelog-paths"},{"title":"Publish a site's Design changes","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/sites/{siteId}/publish","href":"/api-reference/sites/publish-a-sites-design-changes"}]}]},{"group":"Brand Identities","expanded":true,"pages":[{"title":"List available brand identities","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities","href":"/api-reference/content/list-available-brand-identities"},{"title":"Get a single brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities/{brandIdentityId}","href":"/api-reference/content/get-a-single-brand-identity"},{"title":"Update a single brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/brand-identities/{brandIdentityId}","href":"/api-reference/content/update-a-single-brand-identity"},{"title":"Delete a single brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/brand-identities/{brandIdentityId}","href":"/api-reference/content/delete-a-single-brand-identity"},{"group":"Generation","expanded":true,"pages":[{"title":"Queue async brand identity generation","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/brand-identities/generate","href":"/api-reference/content/queue-async-brand-identity-generation"},{"title":"Get async brand identity generation status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities/generate/{jobId}","href":"/api-reference/content/get-async-brand-identity-generation-status"}]},{"group":"Colors","expanded":true,"pages":[{"title":"List brand colors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/brand-identities/{brandIdentityId}/colors","href":"/api-reference/content/list-brand-colors"},{"title":"Add a brand color","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/brand-identities/{brandIdentityId}/colors","href":"/api-reference/content/add-a-brand-color"},{"title":"Update a brand color","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/brand-identities/{brandIdentityId}/colors/{colorId}","href":"/api-reference/content/update-a-brand-color"},{"title":"Delete a brand color","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/brand-identities/{brandIdentityId}/colors/{colorId}","href":"/api-reference/content/delete-a-brand-color"}]}]},{"group":"Integrations","expanded":true,"pages":[{"title":"List available integrations","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/integrations","href":"/api-reference/content/list-available-integrations"},{"title":"Create a GitHub integration","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/integrations/github","href":"/api-reference/content/create-a-github-integration"},{"title":"List recent GitHub activity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/integrations/github/{integrationId}/activity","href":"/api-reference/content/list-recent-github-activity"},{"title":"Delete a single integration","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/integrations/{integrationId}","href":"/api-reference/content/delete-a-single-integration"}]},{"group":"Schedules","expanded":true,"pages":[{"title":"List schedules","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/schedules","href":"/api-reference/schedules/list-schedules"},{"title":"Create a schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/schedules","href":"/api-reference/schedules/create-a-schedule"},{"title":"Update a schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/schedules/{scheduleId}","href":"/api-reference/schedules/update-a-schedule"},{"title":"Delete a schedule","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/schedules/{scheduleId}","href":"/api-reference/schedules/delete-a-schedule"},{"title":"Run a schedule now","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/schedules/{scheduleId}/run","href":"/api-reference/schedules/run-a-schedule-now"},{"title":"List a schedule's runs","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/schedules/{scheduleId}/runs","href":"/api-reference/schedules/list-a-schedules-runs"}]},{"group":"Event Triggers","expanded":true,"pages":[{"title":"List event triggers","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/event-triggers","href":"/api-reference/event-triggers/list-event-triggers"},{"title":"Create an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/event-triggers","href":"/api-reference/event-triggers/create-an-event-trigger"},{"title":"Get an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/event-triggers/{triggerId}","href":"/api-reference/event-triggers/get-an-event-trigger"},{"title":"Update an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/event-triggers/{triggerId}","href":"/api-reference/event-triggers/update-an-event-trigger"},{"title":"Delete an event trigger","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/event-triggers/{triggerId}","href":"/api-reference/event-triggers/delete-an-event-trigger"}]},{"group":"Webhooks","expanded":true,"pages":[{"title":"List outbound webhook subscriptions","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/webhooks","href":"/api-reference/webhooks/list-outbound-webhook-subscriptions"},{"title":"Subscribe an HTTPS endpoint to Notra events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/webhooks","href":"/api-reference/webhooks/subscribe-an-https-endpoint-to-notra-events"},{"title":"Remove a webhook subscription and cancel unsent deliveries","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/webhooks/{endpointId}","href":"/api-reference/webhooks/remove-a-webhook-subscription-and-cancel-unsent-deliveries"},{"group":"Deliveries","expanded":true,"pages":[{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/webhooks/deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Get payload and attempt history for a delivery","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/webhooks/deliveries/{deliveryId}","href":"/api-reference/webhooks/get-payload-and-attempt-history-for-a-delivery"},{"title":"Retry a failed delivery, retaining its history","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/webhooks/deliveries/{deliveryId}/retry","href":"/api-reference/webhooks/retry-a-failed-delivery-retaining-its-history"}]}]},{"group":"Skills","expanded":true,"pages":[{"title":"List skills","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/skills","href":"/api-reference/skills/list-skills"},{"title":"Create a skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/skills","href":"/api-reference/skills/create-a-skill"},{"title":"Get a single skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/skills/{name}","href":"/api-reference/skills/get-a-single-skill"},{"title":"Update a skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/skills/{name}","href":"/api-reference/skills/update-a-skill"},{"title":"Delete a skill","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/skills/{name}","href":"/api-reference/skills/delete-a-skill"}]},{"group":"Chats","expanded":true,"pages":[{"title":"List chats","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/chats","href":"/api-reference/chats/list-chats"},{"title":"Start a new chat and stream the reply","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/chats","href":"/api-reference/chats/start-a-new-chat-and-stream-the-reply"},{"title":"Get a chat by external channel id","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/chats/by-external","href":"/api-reference/chats/get-a-chat-by-external-channel-id"},{"title":"Get a single chat with messages","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/chats/{chatId}","href":"/api-reference/chats/get-a-single-chat-with-messages"},{"title":"Post a message to an existing chat and stream the reply","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/chats/{chatId}","href":"/api-reference/chats/post-a-message-to-an-existing-chat-and-stream-the-reply"}]},{"group":"Feedback","expanded":true,"pages":[{"title":"Submit feedback to an organization's feedback URL","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/feedback/{organizationSlug}","href":"/api-reference/feedback/submit-feedback-to-an-organizations-feedback-url"},{"title":"Submit feedback with an API key","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/feedback","href":"/api-reference/feedback/submit-feedback-with-an-api-key"},{"title":"List feedback","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/feedback","href":"/api-reference/feedback/list-feedback"},{"title":"Get a single feedback entry","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/feedback/{feedbackId}","href":"/api-reference/feedback/get-a-single-feedback-entry"},{"title":"Update feedback status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/feedback/{feedbackId}","href":"/api-reference/feedback/update-feedback-status"}]},{"group":"GEO","expanded":true,"pages":[{"group":"Projects","expanded":true,"pages":[{"title":"List GEO projects","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects","href":"/api-reference/geo/list-geo-projects"},{"title":"Create a GEO project","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects","href":"/api-reference/geo/create-a-geo-project"},{"title":"Get a single GEO project","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}","href":"/api-reference/geo/get-a-single-geo-project"},{"title":"Rename a GEO project or relink its brand identity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}","href":"/api-reference/geo/rename-a-geo-project-or-relink-its-brand-identity"},{"title":"Delete a GEO project and all of its GEO data","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}","href":"/api-reference/geo/delete-a-geo-project-and-all-of-its-geo-data"}]},{"group":"Settings","expanded":true,"pages":[{"title":"Get a project's GEO settings","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/settings","href":"/api-reference/geo/get-a-projects-geo-settings"},{"title":"List the answer engines a project can track","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/engines","href":"/api-reference/geo/list-the-answer-engines-a-project-can-track"},{"title":"Replace a project's GEO settings","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/settings","href":"/api-reference/geo/replace-a-projects-geo-settings"}]},{"group":"Prompts","expanded":true,"pages":[{"title":"List tracked GEO prompts","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/prompts","href":"/api-reference/geo/list-tracked-geo-prompts"},{"title":"Track a new GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts","href":"/api-reference/geo/track-a-new-geo-prompt"},{"title":"Update a tracked GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/prompts/{promptId}","href":"/api-reference/geo/update-a-tracked-geo-prompt"},{"title":"Stop tracking a GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/prompts/{promptId}","href":"/api-reference/geo/stop-tracking-a-geo-prompt"},{"title":"Bulk import GEO prompts","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts/import","href":"/api-reference/geo/bulk-import-geo-prompts"},{"title":"Get the stored check history for one prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/prompts/{promptId}/history","href":"/api-reference/geo/get-the-stored-check-history-for-one-prompt"},{"title":"List prompt suggestions","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/prompts/suggestions","href":"/api-reference/geo/list-prompt-suggestions"},{"title":"Accept a prompt suggestion","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts/suggestions/{suggestionId}/accept","href":"/api-reference/geo/accept-a-prompt-suggestion"},{"title":"Dismiss a prompt suggestion","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/prompts/suggestions/{suggestionId}/dismiss","href":"/api-reference/geo/dismiss-a-prompt-suggestion"}]},{"group":"Sequences","expanded":true,"pages":[{"title":"List GEO prompt sequences","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sequences","href":"/api-reference/geo/list-geo-prompt-sequences"},{"title":"Create a GEO prompt sequence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/sequences","href":"/api-reference/geo/create-a-geo-prompt-sequence"},{"title":"Update a GEO prompt sequence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/sequences/{sequenceId}","href":"/api-reference/geo/update-a-geo-prompt-sequence"},{"title":"Delete a GEO prompt sequence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/sequences/{sequenceId}","href":"/api-reference/geo/delete-a-geo-prompt-sequence"},{"title":"Run a GEO prompt sequence now","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/sequences/{sequenceId}/run","href":"/api-reference/geo/run-a-geo-prompt-sequence-now"}]},{"group":"Personas","expanded":true,"pages":[{"title":"List GEO personas","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas","href":"/api-reference/geo/list-geo-personas"},{"title":"Generate GEO personas","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/personas/generate","href":"/api-reference/geo/generate-geo-personas"},{"title":"Get the GEO persona generation status","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas/generation","href":"/api-reference/geo/get-the-geo-persona-generation-status"},{"title":"Get GEO persona activity","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas/activity","href":"/api-reference/geo/get-geo-persona-activity"},{"title":"Update a GEO persona","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/personas/{personaId}","href":"/api-reference/geo/update-a-geo-persona"},{"title":"Archive a GEO persona","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/personas/{personaId}","href":"/api-reference/geo/archive-a-geo-persona"},{"title":"Restore an archived GEO persona","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/personas/{personaId}/restore","href":"/api-reference/geo/restore-an-archived-geo-persona"},{"title":"Run a GEO persona now","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/personas/{personaId}/run","href":"/api-reference/geo/run-a-geo-persona-now"},{"title":"Get a GEO persona's conversation results","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/personas/{personaId}/results","href":"/api-reference/geo/get-a-geo-personas-conversation-results"}]},{"group":"Competitors","expanded":true,"pages":[{"title":"List tracked GEO competitors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/competitors","href":"/api-reference/geo/list-tracked-geo-competitors"},{"title":"Create or update a tracked GEO competitor","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json put /v1/projects/{projectId}/geo/competitors","href":"/api-reference/geo/create-or-update-a-tracked-geo-competitor"},{"title":"Suggest GEO competitors for a domain","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/competitors/suggestions","href":"/api-reference/geo/suggest-geo-competitors-for-a-domain"},{"title":"Stop tracking a GEO competitor","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json delete /v1/projects/{projectId}/geo/competitors/{name}","href":"/api-reference/geo/stop-tracking-a-geo-competitor"},{"title":"Bulk import GEO competitors","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/competitors/import","href":"/api-reference/geo/bulk-import-geo-competitors"}]},{"group":"Scans","expanded":true,"pages":[{"title":"Trigger a GEO scan","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/scans","href":"/api-reference/geo/trigger-a-geo-scan"},{"title":"List GEO scans","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/scans","href":"/api-reference/geo/list-geo-scans"},{"title":"Get a single GEO scan","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/scans/{scanId}","href":"/api-reference/geo/get-a-single-geo-scan"},{"title":"Rescan a single GEO prompt","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/scans/prompts/{promptId}","href":"/api-reference/geo/rescan-a-single-geo-prompt"},{"title":"Compare the two latest GEO scans","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/changes","href":"/api-reference/geo/compare-the-two-latest-geo-scans"}]},{"group":"Visibility","expanded":true,"pages":[{"title":"Get mention rates per engine","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/overview","href":"/api-reference/geo/get-mention-rates-per-engine"},{"title":"Get daily mention counts per engine","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/timeseries","href":"/api-reference/geo/get-daily-mention-counts-per-engine"},{"title":"Get the latest answer per prompt and engine","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/prompt-results","href":"/api-reference/geo/get-the-latest-answer-per-prompt-and-engine"},{"title":"List compact prompt result summaries","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/prompt-results/summaries","href":"/api-reference/geo/list-compact-prompt-result-summaries"},{"title":"Get one full prompt result","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/prompt-results/{checkId}","href":"/api-reference/geo/get-one-full-prompt-result"},{"title":"Get share of voice across tracked brands","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/competitor-share","href":"/api-reference/geo/get-share-of-voice-across-tracked-brands"},{"title":"Get mention rates per tracked language","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/language-share","href":"/api-reference/geo/get-mention-rates-per-tracked-language"},{"title":"Get one competitor's mention history","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/visibility/competitors/{brand}","href":"/api-reference/geo/get-one-competitors-mention-history"},{"title":"List stored GEO shelf sources","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/shelf-sources","href":"/api-reference/geo/list-stored-geo-shelf-sources"}]},{"group":"Sentiment","expanded":true,"pages":[{"title":"Get aggregate GEO sentiment","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sentiment","href":"/api-reference/geo/get-aggregate-geo-sentiment"},{"title":"Get the stored GEO sentiment analysis","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sentiment/analysis","href":"/api-reference/geo/get-the-stored-geo-sentiment-analysis"},{"title":"List answers used as sentiment evidence","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/sentiment/evidence","href":"/api-reference/geo/list-answers-used-as-sentiment-evidence"}]},{"group":"Content Gaps and Briefs","expanded":true,"pages":[{"title":"List content gaps","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/gaps","href":"/api-reference/geo/list-content-gaps"},{"title":"Ignore or restore a content gap","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/gaps/{promptId}","href":"/api-reference/geo/ignore-or-restore-a-content-gap"},{"title":"List content briefs","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/briefs","href":"/api-reference/geo/list-content-briefs"},{"title":"Plan a content brief","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/briefs","href":"/api-reference/geo/plan-a-content-brief"},{"title":"Get a single content brief","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/briefs/{briefId}","href":"/api-reference/geo/get-a-single-content-brief"},{"title":"Update a content brief","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json patch /v1/projects/{projectId}/geo/briefs/{briefId}","href":"/api-reference/geo/update-a-content-brief"},{"title":"Approve a brief and start the writer","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/briefs/{briefId}/approve","href":"/api-reference/geo/approve-a-brief-and-start-the-writer"}]},{"group":"Agent Readiness","expanded":true,"pages":[{"title":"Get the latest agent readiness report","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/agent-readiness","href":"/api-reference/geo/get-the-latest-agent-readiness-report"},{"title":"Start an agent readiness scan","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/projects/{projectId}/geo/agent-readiness/scan","href":"/api-reference/geo/start-an-agent-readiness-scan"}]},{"group":"Traffic","expanded":true,"pages":[{"title":"Get AI traffic totals and sources","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/overview","href":"/api-reference/geo/get-ai-traffic-totals-and-sources"},{"title":"Get recent AI traffic events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/log","href":"/api-reference/geo/get-recent-ai-traffic-events"},{"title":"List AI traffic journeys","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/journeys","href":"/api-reference/geo/list-ai-traffic-journeys"},{"title":"Get one journey's events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/journeys/{journeyId}","href":"/api-reference/geo/get-one-journeys-events"},{"title":"Get AI journey statistics","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/journey-stats","href":"/api-reference/geo/get-ai-journey-statistics"},{"title":"List the most visited pages","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/pages","href":"/api-reference/geo/list-the-most-visited-pages"},{"title":"Get MCP server analytics","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/mcp","href":"/api-reference/geo/get-mcp-server-analytics"},{"title":"Get one MCP tool's analytics","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/mcp/tools/{toolName}","href":"/api-reference/geo/get-one-mcp-tools-analytics"}]},{"group":"Website Analytics","expanded":true,"pages":[{"title":"Get website analytics totals and trend","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/web","href":"/api-reference/geo/get-website-analytics-totals-and-trend"},{"title":"Get website analytics breakdowns","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/web/breakdowns","href":"/api-reference/geo/get-website-analytics-breakdowns"},{"title":"Get website sessions by UTM parameter","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/web/utm","href":"/api-reference/geo/get-website-sessions-by-utm-parameter"},{"title":"List history imports","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/projects/{projectId}/geo/traffic/imports","href":"/api-reference/geo/list-history-imports"}]},{"group":"Traffic Ingest","expanded":true,"pages":[{"title":"Get the install snippets","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v1/geo/ingest/setup","href":"/api-reference/geo/get-the-install-snippets"},{"title":"Issue the tracking token","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/geo/ingest/token","href":"/api-reference/geo/issue-the-tracking-token"},{"title":"Rotate the tracking token","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v1/geo/ingest/rotate-token","href":"/api-reference/geo/rotate-the-tracking-token"}]}]},{"group":"Agent","expanded":true,"pages":[{"title":"Start a durable agent session","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v2/eve/v1/session","href":"/api-reference/agent/start-a-durable-agent-session"},{"title":"Send a follow-up message or answer a pending input request","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json post /v2/eve/v1/session/{sessionId}","href":"/api-reference/agent/send-a-follow-up-message-or-answer-a-pending-input-request"},{"title":"Stream an agent session's events","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v2/eve/v1/session/{sessionId}/stream","href":"/api-reference/agent/stream-an-agent-sessions-events"},{"title":"List agent sessions","deprecated":null,"version":null,"openapi":"https://api.usenotra.com/openapi.json get /v2/agent-chats","href":"/api-reference/agent/list-agent-sessions"}]}]}]}]},"basePath":"","title":"Queue async post generation - Notra Documentation","deploymentId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","buildId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-GKHRyhW5.js","utils-CXMoydtj.js","cloneDeep-Cl7CR73B.js","_Uint8Array-7sQhd3aE.js","isObject-FP1Yky1u.js","utils-ABJ_F6Yn.js","addUniqueKeysToSchema-B7v39GOQ.js","snippetPresets-CgibLHmh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C2n3VqMC.js","isEqual-BKe3Q7nP.js","usePlaygroundInputsStore-Iji6acs6.js","shallow-Db9K5ulX.js","getApiPlaygroundDisplay-BGnJQBSj.js","CodeSnippet-DlQqWRja.js","CodeSnippets-JF3Bj6-U.js","Page-Ctn-BHcp.js","getPastedJson-B0pIrOza.js","icon-UPBYC1Wr.js","MethodPill-CoVRW5MG.js","DuplicateIcon-BuNnsqwg.js","createIcon-Cj9cJegl.js","DynamicMarkdown-C_R66tyH.js","SectionHeading-C6RB-y9f.js","axios-vUo_bRtp.js","Markdown-g2PbGssl.js","dist-DbZ3bm7k.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-BGnit25E.js"]}