Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site’s blog.json, the same draft the dashboard’s Design tab shows, and go live when published with POST /v1/sites//publish or from the dashboard.
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.
Ids whose avatar was a dashboard upload, which only the dashboard import can copy into the site. Set their avatar with PUT afterwards.
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":"6af55ae354881783984abc26","clientVersion":"0.0.4111","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":"llms-txt-v2","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}],"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/sites/import-notra-authors-into-a-site","slug":"/api-reference/sites/import-notra-authors-into-a-site","pageMetadata":{"title":"Import Notra authors into a site","description":"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.","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","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: [\"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site’s blog.json, the same draft the dashboard’s Design tab shows, and go live when published with POST /v1/sites/\", \"/publish or from the dashboard.\"]\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":"Import Notra authors into a site","description":"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.","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","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":["Sites"],"operationId":"importSiteAuthors","summary":"Import Notra authors into a site","description":"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.","parameters":["30152136-f08f-4028-8bc6-8bb3cd3accff"],"requestBody":"efef5c6c-2364-4d12-aadb-5b365dfffbfc","responses":{"200":"5faab4d8-c26f-4a28-9b28-b00a1a918e89","400":"f3c58001-eb00-4137-8fbf-923f478b78c1","401":"c8f1b034-1f19-48d0-8014-618ec634242a","403":"5d11b575-5d63-44e3-bd81-ee06565d869e","404":"48d8409b-9417-477c-b0a1-47d20bbd1d4f","409":"3ec7f8af-f11b-472b-ba3a-d9f1305d4714","429":"f2e266fb-2dbd-49a5-b50c-98389b16e637","503":"61eab79a-43d5-443f-9c38-3bb27e5a2dea","504":"2aea08bb-c76e-45fc-baf6-e3c25ffe259b"},"method":"post","type":"path","servers":["fb211914-76df-45d3-8099-6ef9da0eba67","511afd44-535b-487f-962b-6c37c6ecebb8"],"security":["51c2dcd1-b8c1-403f-90bc-1b4111aebea6"],"path":"/v1/sites/{siteId}/authors/import","baseUrlOptions":["https://api.usenotra.com","https://demo-api.usenotra.com"],"title":"Import Notra authors into a site","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"30152136-f08f-4028-8bc6-8bb3cd3accff":{"schema":{"type":"string","minLength":1,"pattern":"^[A-Za-z0-9_-]{1,100}$","example":"site_8f2kq1","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"in":"path","name":"siteId"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"authorIds":{"type":"array","items":{"type":"string","minLength":1,"pattern":"^[A-Za-z0-9_-]{1,100}$","uniqueKey":"authorIds.items.[INDEX]","typeLabel":"string"},"minItems":1,"maxItems":100,"description":"Notra author IDs from GET /v1/posts/authors. Omit to import every Notra author whose slug is not in blog.json yet.","example":["auth_8f2kq1"],"uniqueKey":"authorIds","typeLabel":"string[]"},"replace":{"type":"boolean","description":"Replace blog.json authors that already use an imported author's slug. Without it they are skipped.","uniqueKey":"replace","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"authorIds":["auth_8f2kq1"],"replace":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5faab4d8-c26f-4a28-9b28-b00a1a918e89":{"description":"Authors imported as unpublished changes","content":{"application/json":{"schema":{"type":"object","required":["imported","avatarsSkipped","site","authors","authorPage","hasUnpublishedChanges"],"properties":{"site":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"site.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"site.name","typeLabel":"string"}},"required":["id","name"],"isRequired":true,"uniqueKey":"site","typeLabel":"object"},"authors":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"jane-doe","isRequired":true,"uniqueKey":"authors.items.[INDEX].id","typeLabel":"string"},"ref":{"type":"string","description":"Pass this in metadata.authorIds of PATCH /v1/posts/{postId} to credit the author on a blog post that publishes to this site.","example":"site:jane-doe","isRequired":true,"uniqueKey":"authors.items.[INDEX].ref","typeLabel":"string"},"name":{"type":"string","example":"Jane Doe","isRequired":true,"uniqueKey":"authors.items.[INDEX].name","typeLabel":"string"},"title":{"oneOf":[{"type":"string","example":"Head of Product","isRequired":true,"uniqueKey":"authors.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","example":"Head of Product","isRequired":true,"uniqueKey":"authors.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].title","typeLabel":"string | null"},"bio":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].bio.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].bio.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].bio","typeLabel":"string | null"},"avatar":{"oneOf":[{"type":"string","description":"As written in blog.json: a site path such as /images/jane.png or an https URL.","example":"/images/jane.png","isRequired":true,"uniqueKey":"authors.items.[INDEX].avatar.oneOf.0","typeLabel":"string"},{"type":"null","description":"As written in blog.json: a site path such as /images/jane.png or an https URL.","example":"/images/jane.png","isRequired":true,"uniqueKey":"authors.items.[INDEX].avatar.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].avatar","typeLabel":"string | null"},"avatarUrl":{"oneOf":[{"type":"string","description":"The avatar as a full URL on the live site.","example":"https://acme.notra.site/blog/images/jane.png","isRequired":true,"uniqueKey":"authors.items.[INDEX].avatarUrl.oneOf.0","typeLabel":"string"},{"type":"null","description":"The avatar as a full URL on the live site.","example":"https://acme.notra.site/blog/images/jane.png","isRequired":true,"uniqueKey":"authors.items.[INDEX].avatarUrl.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].avatarUrl","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","example":"https://janedoe.dev","isRequired":true,"uniqueKey":"authors.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://janedoe.dev","isRequired":true,"uniqueKey":"authors.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].url","typeLabel":"string | null"},"x":{"oneOf":[{"type":"string","example":"https://x.com/janedoe","isRequired":true,"uniqueKey":"authors.items.[INDEX].x.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://x.com/janedoe","isRequired":true,"uniqueKey":"authors.items.[INDEX].x.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].x","typeLabel":"string | null"},"linkedin":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].linkedin.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].linkedin.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].linkedin","typeLabel":"string | null"},"github":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].github.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].github.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].github","typeLabel":"string | null"},"youtube":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].youtube.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].youtube.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].youtube","typeLabel":"string | null"},"bluesky":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].bluesky.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].bluesky.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].bluesky","typeLabel":"string | null"},"mastodon":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].mastodon.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].mastodon.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].mastodon","typeLabel":"string | null"},"threads":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].threads.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].threads.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].threads","typeLabel":"string | null"},"instagram":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"authors.items.[INDEX].instagram.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"authors.items.[INDEX].instagram.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"authors.items.[INDEX].instagram","typeLabel":"string | null"},"live":{"type":"boolean","description":"The author is in the published blog.json. False while it only exists in unpublished changes.","example":true,"isRequired":true,"uniqueKey":"authors.items.[INDEX].live","typeLabel":"boolean"},"posts":{"type":"integer","description":"Notra blog posts on this site that credit the author.","example":3,"isRequired":true,"uniqueKey":"authors.items.[INDEX].posts","typeLabel":"integer"}},"required":["id","ref","name","title","bio","avatar","avatarUrl","url","x","linkedin","github","youtube","bluesky","mastodon","threads","instagram","live","posts"],"uniqueKey":"authors.items.[INDEX]","typeLabel":"object"},"description":"Authors in blog.json order, including unpublished changes.","isRequired":true,"uniqueKey":"authors","typeLabel":"object[]"},"authorPage":{"type":"string","enum":["inline","stacked"],"description":"Layout of every author page: inline puts the avatar beside the name, stacked puts it above.","example":"inline","isRequired":true,"uniqueKey":"authorPage","typeLabel":"enum\u003cstring>"},"hasUnpublishedChanges":{"type":"boolean","description":"blog.json has staged Design changes that are not live yet. Publish them with POST /v1/sites/{siteId}/publish or from the dashboard.","example":true,"isRequired":true,"uniqueKey":"hasUnpublishedChanges","typeLabel":"boolean"},"imported":{"type":"array","items":{"type":"string","uniqueKey":"imported.items.[INDEX]","typeLabel":"string"},"description":"Ids written to blog.json.","example":["jane-doe"],"isRequired":true,"uniqueKey":"imported","typeLabel":"string[]"},"avatarsSkipped":{"type":"array","items":{"type":"string","uniqueKey":"avatarsSkipped.items.[INDEX]","typeLabel":"string"},"description":"Ids whose avatar was a dashboard upload, which only the dashboard import can copy into the site. Set their avatar with PUT afterwards.","isRequired":true,"uniqueKey":"avatarsSkipped","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"site":{"id":"\u003cstring>","name":"\u003cstring>"},"authors":[{"id":"jane-doe","ref":"site:jane-doe","name":"Jane Doe","title":"Head of Product","bio":"\u003cstring>","avatar":"/images/jane.png","avatarUrl":"https://acme.notra.site/blog/images/jane.png","url":"https://janedoe.dev","x":"https://x.com/janedoe","linkedin":"\u003cstring>","github":"\u003cstring>","youtube":"\u003cstring>","bluesky":"\u003cstring>","mastodon":"\u003cstring>","threads":"\u003cstring>","instagram":"\u003cstring>","live":true,"posts":3}],"authorPage":"inline","hasUnpublishedChanges":true,"imported":["jane-doe"],"avatarsSkipped":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"f3c58001-eb00-4137-8fbf-923f478b78c1":{"description":"Invalid path params or 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"},"c8f1b034-1f19-48d0-8014-618ec634242a":{"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"},"5d11b575-5d63-44e3-bd81-ee06565d869e":{"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"},"48d8409b-9417-477c-b0a1-47d20bbd1d4f":{"description":"Site or author 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"},"3ec7f8af-f11b-472b-ba3a-d9f1305d4714":{"description":"The site has no blog, blog.json can't be edited as it is, another editor changed it meanwhile, or the author is in use (code SITE_AUTHOR_IN_USE)","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"},"f2e266fb-2dbd-49a5-b50c-98389b16e637":{"description":"Rate limit exceeded. This endpoint allows 60 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,"isRequired":true,"uniqueKey":"limit","typeLabel":"integer"},"remaining":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"remaining","typeLabel":"integer"},"reset":{"type":"integer","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"},"61eab79a-43d5-443f-9c38-3bb27e5a2dea":{"description":"Notra Sites or authentication is unavailable","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"},"2aea08bb-c76e-45fc-baf6-e3c25ffe259b":{"description":"The site's repository didn't answer in time","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"}},"security":{"51c2dcd1-b8c1-403f-90bc-1b4111aebea6":{"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":{"fb211914-76df-45d3-8099-6ef9da0eba67":{"url":"https://api.usenotra.com","description":"Production"},"511afd44-535b-487f-962b-6c37c6ecebb8":{"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":"Import Notra authors into a site - Notra Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/sites/import-notra-authors-into-a-site.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=\"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site\u0026#x27;s blog.json, the same draft the dashboard\u0026#x27;s Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.\">\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=\"Import Notra authors into a site - Notra Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site\u0026#x27;s blog.json, the same draft the dashboard\u0026#x27;s Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.\">\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/sites/import-notra-authors-into-a-site\">\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=Authors+and+Design\u0026amp;title=Import+Notra+authors+into+a+site\u0026amp;description=Copies+Notra+authors+%28GET+%2Fv1%2Fposts%2Fauthors%29+into+blog.json%2C+using+their+slug+as+the+id.+Avatars+on+https+URLs+are+kept%3B+dashboard+uploads+are+listed+in+avatars\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=37a365e8c4b134f09b07192996313c23b4fa00df4610c863ee8b806e522aaa10\">\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=\"Import Notra authors into a site - Notra Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site\u0026#x27;s blog.json, the same draft the dashboard\u0026#x27;s Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://notra.mintlify.site/docs/_mintlify/api/og/v2?division=Authors+and+Design\u0026amp;title=Import+Notra+authors+into+a+site\u0026amp;description=Copies+Notra+authors+%28GET+%2Fv1%2Fposts%2Fauthors%29+into+blog.json%2C+using+their+slug+as+the+id.+Avatars+on+https+URLs+are+kept%3B+dashboard+uploads+are+listed+in+avatars\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=37a365e8c4b134f09b07192996313c23b4fa00df4610c863ee8b806e522aaa10\">\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/sites/import-notra-authors-into-a-site\">\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/sites/import-notra-authors-into-a-site.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/sites/import-notra-authors-into-a-site#webpage\",\"url\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site\",\"name\":\"Import Notra authors into a site\",\"description\":\"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.\",\"isPartOf\":{\"@id\":\"https://www.usenotra.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site#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\":\"Sites\",\"item\":\"https://www.usenotra.com/docs/api-reference/sites/list-notra-sites\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Authors and Design\",\"item\":\"https://www.usenotra.com/docs/api-reference/sites/list-a-sites-authors\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Import Notra authors into a site\",\"item\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site#apireference\",\"headline\":\"Import Notra authors into a site\",\"name\":\"Import Notra authors into a site\",\"description\":\"Copies Notra authors (GET /v1/posts/authors) into blog.json, using their slug as the id. Avatars on https URLs are kept; dashboard uploads are listed in avatarsSkipped. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.\",\"url\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site\",\"mainEntityOfPage\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/import-notra-authors-into-a-site#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/sites/import-notra-authors-into-a-site.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","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","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","description":"Removes the author from blog.json. Deleting one that is live or credited on Notra posts needs force=true; those posts then show the id as a plain name. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.","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","description":"Sets blog.authorPage, the layout of every author page. Changes are saved as unpublished Design changes to the site's blog.json, the same draft the dashboard's Design tab shows, and go live when published with POST /v1/sites/{siteId}/publish or from the dashboard.","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":"Import Notra authors into a site - Notra Documentation","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","Page-DvEUoD2H.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}