Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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.
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
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/create-or-update-a-site-author","slug":"/api-reference/sites/create-or-update-a-site-author","pageMetadata":{"title":"Create or update a site author","description":"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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 put /v1/sites/{siteId}/authors/{authorId}","href":"/api-reference/sites/create-or-update-a-site-author","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: [\"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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":"Create or update a site author","description":"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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 put /v1/sites/{siteId}/authors/{authorId}","href":"/api-reference/sites/create-or-update-a-site-author","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":"upsertSiteAuthor","summary":"Create or update a site author","description":"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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":["edbf9122-09a5-4b30-892a-3da720467f8e","f81a7fa3-5d22-45bb-adb9-3399655353f8"],"requestBody":"e57037be-322b-41f9-aed1-a9b4ea63dba5","responses":{"200":"9639b37e-966f-49bb-9f2d-f43da920a420","400":"48b2f2f3-e2bb-4380-9e9a-52560e672e61","401":"94773b5c-d1f2-48bd-b046-10b70d0890ad","403":"881920e2-942f-4033-9520-7c656f33a38b","404":"b73b8678-795c-4e17-8c98-cc4c796da13e","409":"4df2883a-24d5-472e-be32-5cc60153f2e5","429":"c5766448-a938-47a6-bf47-844b12193be8","503":"da0e6b20-596b-4acc-88df-09073e9384b0","504":"a32f223a-05f1-48fc-bb4e-5053282c2591"},"method":"put","type":"path","servers":["fb211914-76df-45d3-8099-6ef9da0eba67","511afd44-535b-487f-962b-6c37c6ecebb8"],"security":["51c2dcd1-b8c1-403f-90bc-1b4111aebea6"],"path":"/v1/sites/{siteId}/authors/{authorId}","baseUrlOptions":["https://api.usenotra.com","https://demo-api.usenotra.com"],"title":"Create or update a site author","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"edbf9122-09a5-4b30-892a-3da720467f8e":{"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"},"f81a7fa3-5d22-45bb-adb9-3399655353f8":{"schema":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$","description":"The author's id in blog.json. Posts name the author with it and its author page lives at {blogMount}/author/{authorId}.","example":"jane-doe","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"description":"The author's id in blog.json. Posts name the author with it and its author page lives at {blogMount}/author/{authorId}.","in":"path","name":"authorId"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80,"isRequired":true,"uniqueKey":"name","typeLabel":"string"},"title":{"oneOf":[{"type":"string","maxLength":80,"uniqueKey":"title.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":80,"uniqueKey":"title.oneOf.1","typeLabel":"null"}],"uniqueKey":"title","typeLabel":"string | null"},"bio":{"oneOf":[{"type":"string","maxLength":300,"uniqueKey":"bio.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":300,"uniqueKey":"bio.oneOf.1","typeLabel":"null"}],"uniqueKey":"bio","typeLabel":"string | null"},"avatar":{"oneOf":[{"type":"string","pattern":"^(?:\\/(?!\\/)|https:\\/\\/)","description":"A path to an image in the site's public folder, such as /images/jane.png, or an https URL.","uniqueKey":"avatar.oneOf.0","typeLabel":"string"},{"type":"null","pattern":"^(?:\\/(?!\\/)|https:\\/\\/)","description":"A path to an image in the site's public folder, such as /images/jane.png, or an https URL.","uniqueKey":"avatar.oneOf.1","typeLabel":"null"}],"uniqueKey":"avatar","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"url.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"url.oneOf.1","typeLabel":"null"}],"uniqueKey":"url","typeLabel":"string\u003curi> | null"},"x":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"x.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"x.oneOf.1","typeLabel":"null"}],"uniqueKey":"x","typeLabel":"string\u003curi> | null"},"linkedin":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"linkedin.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"linkedin.oneOf.1","typeLabel":"null"}],"uniqueKey":"linkedin","typeLabel":"string\u003curi> | null"},"github":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"github.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"github.oneOf.1","typeLabel":"null"}],"uniqueKey":"github","typeLabel":"string\u003curi> | null"},"youtube":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"youtube.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"youtube.oneOf.1","typeLabel":"null"}],"uniqueKey":"youtube","typeLabel":"string\u003curi> | null"},"bluesky":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"bluesky.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"bluesky.oneOf.1","typeLabel":"null"}],"uniqueKey":"bluesky","typeLabel":"string\u003curi> | null"},"mastodon":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"mastodon.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"mastodon.oneOf.1","typeLabel":"null"}],"uniqueKey":"mastodon","typeLabel":"string\u003curi> | null"},"threads":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"threads.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"threads.oneOf.1","typeLabel":"null"}],"uniqueKey":"threads","typeLabel":"string\u003curi> | null"},"instagram":{"oneOf":[{"type":"string","format":"uri","uniqueKey":"instagram.oneOf.0","typeLabel":"string\u003curi>"},{"type":"null","format":"uri","uniqueKey":"instagram.oneOf.1","typeLabel":"null"}],"uniqueKey":"instagram","typeLabel":"string\u003curi> | null"},"previousId":{"type":"string","pattern":"^[a-z0-9](?:[a-z0-9-]{0,38}[a-z0-9])?$","description":"Renames the author with this id to authorId, keeping its place in blog.json. Posts that name the old id lose the link until they name the new one.","example":"jane","uniqueKey":"previousId","typeLabel":"string"},"force":{"type":"boolean","description":"Confirms renaming an author that is live or credited on Notra posts.","uniqueKey":"force","typeLabel":"boolean"}},"required":["name"],"description":"The whole author: fields you leave out are removed. Links must be https URLs.","example":{"name":"Jane Doe","title":"Head of Product","avatar":"/images/jane.png","x":"https://x.com/janedoe"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Jane Doe","title":"Head of Product","avatar":"/images/jane.png","x":"https://x.com/janedoe"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"9639b37e-966f-49bb-9f2d-f43da920a420":{"description":"Author saved as an unpublished change","content":{"application/json":{"schema":{"type":"object","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"}},"required":["site","authors","authorPage","hasUnpublishedChanges"],"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}}},"exampleType":"generated"}},"exampleType":"generated"},"48b2f2f3-e2bb-4380-9e9a-52560e672e61":{"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"},"94773b5c-d1f2-48bd-b046-10b70d0890ad":{"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"},"881920e2-942f-4033-9520-7c656f33a38b":{"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"},"b73b8678-795c-4e17-8c98-cc4c796da13e":{"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"},"4df2883a-24d5-472e-be32-5cc60153f2e5":{"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"},"c5766448-a938-47a6-bf47-844b12193be8":{"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"},"da0e6b20-596b-4acc-88df-09073e9384b0":{"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"},"a32f223a-05f1-48fc-bb4e-5053282c2591":{"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":"Create or update a site author - Notra Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"api-reference/sites/create-or-update-a-site-author.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=\"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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=\"Create or update a site author - Notra Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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/create-or-update-a-site-author\">\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=Create+or+update+a+site+author\u0026amp;description=Creates+the+author+or+replaces+all+of+its+fields.+Send+previousId+to+rename+an+author%3B+renaming+one+that+is+live+or+credited+on+Notra+posts+needs+force%3A+true%2C+s\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=31f666307aac82b4b956e5018e4de6736148307e4fbae94558d96163c2f8a6d7\">\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=\"Create or update a site author - Notra Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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=Create+or+update+a+site+author\u0026amp;description=Creates+the+author+or+replaces+all+of+its+fields.+Send+previousId+to+rename+an+author%3B+renaming+one+that+is+live+or+credited+on+Notra+posts+needs+force%3A+true%2C+s\u0026amp;theme=ee1615b07fb0909d0eced992\u0026amp;signature=31f666307aac82b4b956e5018e4de6736148307e4fbae94558d96163c2f8a6d7\">\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/create-or-update-a-site-author\">\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/create-or-update-a-site-author.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/create-or-update-a-site-author#webpage\",\"url\":\"https://www.usenotra.com/docs/api-reference/sites/create-or-update-a-site-author\",\"name\":\"Create or update a site author\",\"description\":\"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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/create-or-update-a-site-author#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/create-or-update-a-site-author#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\":\"Create or update a site author\",\"item\":\"https://www.usenotra.com/docs/api-reference/sites/create-or-update-a-site-author\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/create-or-update-a-site-author#apireference\",\"headline\":\"Create or update a site author\",\"name\":\"Create or update a site author\",\"description\":\"Creates the author or replaces all of its fields. Send previousId to rename an author; renaming one that is live or credited on Notra posts needs force: true, since those posts lose the link. 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/create-or-update-a-site-author\",\"mainEntityOfPage\":{\"@id\":\"https://www.usenotra.com/docs/api-reference/sites/create-or-update-a-site-author#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/create-or-update-a-site-author.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","description":"Returns the authors in the site's blog.json, including unpublished Design changes, with how many Notra posts credit each one, plus the author page layout.","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","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":"Create or update a site author - 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"]}