Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website’s monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer’s own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AthenaHQ","colors":{"primary":"#4f39f6","light":"#7c86ff","dark":"#4f39f6"},"logo":{"light":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68","dark":"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68"},"favicon":"https://mintcdn.com/athenahq/l-RALGQGlLg9vCM3/favicon.ico?fit=max\u0026auto=format\u0026n=l-RALGQGlLg9vCM3\u0026q=85\u0026s=902f75ca9d61dedcf06910b630c2349b","navbar":{"links":[{"href":"mailto:support@athenahq.ai","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.athenahq.ai/settings/api"}},"footer":{"socials":{"website":"https://athenahq.ai","linkedin":"https://linkedin.com/company/athena-hq"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"athenahq","hasAudioNarration":false,"actualSubdomain":"athenahq","customDomains":["docs.athenahq.ai"],"gitSource":{"type":"github","owner":"ay-ay-ay-ay","repo":"athenahq","deployBranch":"main","contentDirectory":"docs-api","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae281d735135ec30d0757eb","collectionId":"635d81b1-093e-4f1d-af7a-54210b12fad7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae281d735135ec30d0757eb"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ae281d735135ec30d0757eb","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":128},{"language":"default","tag":"Documentation","count":63},{"language":"default","tag":"Page Reference","count":55},{"language":"default","tag":"Content \u0026 Knowledge","count":38},{"language":"default","tag":"Core Resources","count":33},{"language":"default","tag":"Administration","count":32},{"language":"default","tag":"Content Hub","count":19},{"language":"default","tag":"Analytics","count":16},{"language":"default","tag":"Knowledge Base","count":15},{"language":"default","tag":"Members","count":12}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/content/track-external-urls","slug":"/api-reference/content/track-external-urls","pageMetadata":{"title":"Track External URLs","description":"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website's monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer's own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/track","href":"/api-reference/content/track-external-urls","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website’s monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer’s own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.\"\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":{"config":{},"pageMetadata":{"title":"Track External URLs","description":"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website's monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer's own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/track","href":"/api-reference/content/track-external-urls","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Content"],"operationId":"content.track_urls","summary":"Track External URLs","description":"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website's monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer's own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.","responses":{"201":"b623bebe-4a0a-469c-b648-083406d19045","400":"1c48b495-3545-41c7-9188-d147f4dc00fe","401":"3fb7b7b3-447d-43e5-a2d1-e93bfa752ed0","403":"3bff50aa-6cd5-45cc-9750-b0491bfa4aff","404":"a35e9ba1-7754-498a-a1a5-d97a42603577","429":"a2fec753-fef6-4d36-891f-e09b256b36d7","500":"96ad52dc-d678-4da7-a8ed-8ca5e5ecdac9"},"requestBody":"29f3ce52-8419-4325-8cd0-615ea38fa5e7","security":["502a9897-4577-4825-9ea3-56d6a09bf8bb"],"method":"post","type":"path","servers":["737f5b54-c5ec-422c-9e02-b1b685106875"],"path":"/api/v1/content/track","baseUrlOptions":["https://api.athenahq.ai"],"title":"Track External URLs","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"website_id":{"type":"string","description":"The website to track the URLs on.","isRequired":true,"uniqueKey":"website_id","typeLabel":"string"},"urls":{"type":"array","minItems":1,"maxItems":500,"description":"Pages to track. A bare domain path like acme.com/blog/post is fine; the protocol is stripped on store.","items":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2048,"isRequired":true,"uniqueKey":"urls.items.[INDEX].url","typeLabel":"string"},"title":{"type":"string","minLength":1,"maxLength":500,"description":"Optional display title. Omitted: derived from the URL slug.","uniqueKey":"urls.items.[INDEX].title","typeLabel":"string"},"fields":{"type":"array","maxItems":50,"description":"Optional values for the customer-created Content Hub columns on the destination tab, written on the created row. Not applied to skipped URLs. Each column may appear once per URL.","items":{"type":"object","properties":{"column":{"type":"string","minLength":1,"maxLength":200,"description":"Column name as shown on the tab (case-insensitive). Writable types: text, number, date, checkbox, link, multi_select. Generated columns (Ask Athena, approval, OG image, ...) are rejected.","isRequired":true,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].column","typeLabel":"string"},"value":{"oneOf":[{"type":"string","description":"Value in the column's type: string for text; http(s) URL string for link; number or numeric string for number; ISO 8601 date string (2026-09-01 or 2026-09-01T10:00:00Z, other formats are rejected; a date-only value is stored as UTC midnight) for date; boolean (or true/false, yes/no) for checkbox; array of option labels, or a comma-separated string, for multi_select (50 labels at most either way). Unknown multi-select options are created; existing ones match case-insensitively.","maxLength":10000,"isRequired":true,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].value.oneOf.0","typeLabel":"string"},{"type":"number","description":"Value in the column's type: string for text; http(s) URL string for link; number or numeric string for number; ISO 8601 date string (2026-09-01 or 2026-09-01T10:00:00Z, other formats are rejected; a date-only value is stored as UTC midnight) for date; boolean (or true/false, yes/no) for checkbox; array of option labels, or a comma-separated string, for multi_select (50 labels at most either way). Unknown multi-select options are created; existing ones match case-insensitively.","isRequired":true,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].value.oneOf.1","typeLabel":"number"},{"type":"boolean","description":"Value in the column's type: string for text; http(s) URL string for link; number or numeric string for number; ISO 8601 date string (2026-09-01 or 2026-09-01T10:00:00Z, other formats are rejected; a date-only value is stored as UTC midnight) for date; boolean (or true/false, yes/no) for checkbox; array of option labels, or a comma-separated string, for multi_select (50 labels at most either way). Unknown multi-select options are created; existing ones match case-insensitively.","isRequired":true,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].value.oneOf.2","typeLabel":"boolean"},{"type":"array","items":{"type":"string","maxLength":200,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].value.oneOf.3.items.[INDEX]","typeLabel":"string"},"description":"Value in the column's type: string for text; http(s) URL string for link; number or numeric string for number; ISO 8601 date string (2026-09-01 or 2026-09-01T10:00:00Z, other formats are rejected; a date-only value is stored as UTC midnight) for date; boolean (or true/false, yes/no) for checkbox; array of option labels, or a comma-separated string, for multi_select (50 labels at most either way). Unknown multi-select options are created; existing ones match case-insensitively.","maxItems":50,"isRequired":true,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].value.oneOf.3","typeLabel":"string[]"}],"isRequired":true,"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX].value","typeLabel":"string | number | boolean | string[]"}},"required":["column","value"],"uniqueKey":"urls.items.[INDEX].fields.items.[INDEX]","typeLabel":"object"},"uniqueKey":"urls.items.[INDEX].fields","typeLabel":"object[]"}},"required":["url"],"uniqueKey":"urls.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"urls","typeLabel":"object[]"},"sheet_id":{"oneOf":[{"type":"string","description":"Content Hub tab to file the new rows under. View-type tabs resolve to the main pool (null).","uniqueKey":"sheet_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Content Hub tab to file the new rows under. View-type tabs resolve to the main pool (null).","uniqueKey":"sheet_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"sheet_id","typeLabel":"string | null"}},"required":["website_id","urls"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"website_id":"\u003cstring>","urls":[{"url":"\u003cstring>","title":"\u003cstring>","fields":[{"column":"\u003cstring>","value":"\u003cstring>"}]}],"sheet_id":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"b623bebe-4a0a-469c-b648-083406d19045":{"description":"Created. Also returned when every URL was already tracked (idempotent success with created_count 0).","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"created_count":{"type":"number","isRequired":true,"uniqueKey":"created_count","typeLabel":"number"},"skipped_count":{"type":"number","isRequired":true,"uniqueKey":"skipped_count","typeLabel":"number"},"created":{"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","isRequired":true,"uniqueKey":"created.items.[INDEX].content_id","typeLabel":"string"},"url":{"type":"string","description":"The stored, protocol-less URL (display form).","isRequired":true,"uniqueKey":"created.items.[INDEX].url","typeLabel":"string"},"destination_name":{"type":"string","description":"The actual destination tab's name, or Shared pool when no shared-pool view exists.","isRequired":true,"uniqueKey":"created.items.[INDEX].destination_name","typeLabel":"string"},"content_hub_url":{"type":"string","format":"uri","description":"Opens the item in Content Hub with its website and destination tab selected.","isRequired":true,"uniqueKey":"created.items.[INDEX].content_hub_url","typeLabel":"string\u003curi>"},"sheet_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"created.items.[INDEX].sheet_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"created.items.[INDEX].sheet_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"created.items.[INDEX].sheet_id","typeLabel":"string | null"}},"required":["content_id","url","sheet_id","destination_name","content_hub_url"],"uniqueKey":"created.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"created","typeLabel":"object[]"},"skipped":{"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"The already-existing row this input URL resolved to.","isRequired":true,"uniqueKey":"skipped.items.[INDEX].content_id","typeLabel":"string"},"url":{"type":"string","description":"The cleaned input URL that was skipped.","isRequired":true,"uniqueKey":"skipped.items.[INDEX].url","typeLabel":"string"},"destination_name":{"type":"string","description":"The existing row's actual destination, which may differ from the requested tab.","isRequired":true,"uniqueKey":"skipped.items.[INDEX].destination_name","typeLabel":"string"},"content_hub_url":{"type":"string","format":"uri","description":"Opens the existing item at its current Content Hub location. Skipped rows are not moved.","isRequired":true,"uniqueKey":"skipped.items.[INDEX].content_hub_url","typeLabel":"string\u003curi>"},"type":{"type":"string","description":"The existing row's content type. external/imported means the URL was already tracked; any other value (draft, snipe, ...) means it collided with first-party generated content sharing the join key - check before chaining destructive calls.","isRequired":true,"uniqueKey":"skipped.items.[INDEX].type","typeLabel":"string"},"sheet_id":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"skipped.items.[INDEX].sheet_id.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"skipped.items.[INDEX].sheet_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"skipped.items.[INDEX].sheet_id","typeLabel":"string | null"}},"required":["content_id","url","type","sheet_id","destination_name","content_hub_url"],"uniqueKey":"skipped.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"skipped","typeLabel":"object[]"}},"required":["success","created_count","skipped_count","created","skipped"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"created_count":123,"skipped_count":123,"created":[{"content_id":"\u003cstring>","url":"\u003cstring>","destination_name":"\u003cstring>","content_hub_url":"\u003cstring>","sheet_id":"\u003cstring>"}],"skipped":[{"content_id":"\u003cstring>","url":"\u003cstring>","destination_name":"\u003cstring>","content_hub_url":"\u003cstring>","type":"\u003cstring>","sheet_id":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"1c48b495-3545-41c7-9188-d147f4dc00fe":{"description":"Bad Request: validation failed (invalid URL in the batch, sheet_id not on this website, or a field naming an unknown column or a value that does not fit its type; nothing is written)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3fb7b7b3-447d-43e5-a2d1-e93bfa752ed0":{"description":"Unauthenticated","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3bff50aa-6cd5-45cc-9750-b0491bfa4aff":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a35e9ba1-7754-498a-a1a5-d97a42603577":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"a2fec753-fef6-4d36-891f-e09b256b36d7":{"description":"Rate Limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"96ad52dc-d678-4da7-a8ed-8ca5e5ecdac9":{"description":"Internal Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"502a9897-4577-4825-9ea3-56d6a09bf8bb":{"ApiKeyAuth":{"$ref":"b24a15f8-3737-4567-b506-8ad3a461d125","scopes":[]}}},"servers":{"737f5b54-c5ec-422c-9e02-b1b685106875":{"url":"https://api.athenahq.ai","description":"Production server"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"athenahq","siteName":"AthenaHQ","title":"Track External URLs - AthenaHQ","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T20:04:57.162Z","originalFileLocation":"api-reference/content/track-external-urls.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=\"system\"}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=\"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website\u0026#x27;s monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer\u0026#x27;s own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_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=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Track External URLs - AthenaHQ\">\u003cmeta data-mint-head property=\"og:description\" content=\"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website\u0026#x27;s monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer\u0026#x27;s own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AthenaHQ\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.athenahq.ai/api-reference/content/track-external-urls\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://athenahq.mintlify.app/_mintlify/api/og/v2?division=Content+Hub\u0026amp;title=Track+External+URLs\u0026amp;description=Register+existing+pages+or+third-party+URLs+as+tracked+Content+Hub+items+so+Athena+attributes+citations+and+mentions+to+them.+Creates+external+content+rows+from\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=0c39ba8fcf6ba24f0ee2c8bbc8c9a3b60e33733ca08303120ea139627fa986ab\">\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=\"Track External URLs - AthenaHQ\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website\u0026#x27;s monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer\u0026#x27;s own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://athenahq.mintlify.app/_mintlify/api/og/v2?division=Content+Hub\u0026amp;title=Track+External+URLs\u0026amp;description=Register+existing+pages+or+third-party+URLs+as+tracked+Content+Hub+items+so+Athena+attributes+citations+and+mentions+to+them.+Creates+external+content+rows+from\u0026amp;theme=0b3a918be6754723090d9161\u0026amp;signature=0c39ba8fcf6ba24f0ee2c8bbc8c9a3b60e33733ca08303120ea139627fa986ab\">\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=\"/mintlify-assets/_mintlify/favicons/athenahq/CgBKLUlhcFuNVwLc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AthenaHQ\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f39f6\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.athenahq.ai/api-reference/content/track-external-urls\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/content/track-external-urls.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.athenahq.ai/#organization\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/athenahq/L9mnbtCFYX94d6KY/logo/ahq_logo.svg?fit=max\u0026auto=format\u0026n=L9mnbtCFYX94d6KY\u0026q=85\u0026s=e929a8fbe48ea55a88a26164326a1b68\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.athenahq.ai#website\",\"name\":\"AthenaHQ\",\"url\":\"https://docs.athenahq.ai\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls#webpage\",\"url\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls\",\"name\":\"Track External URLs\",\"description\":\"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website's monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer's own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.\",\"dateModified\":\"2026-10-27T20:04:57.162Z\",\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Content \u0026 Knowledge\",\"item\":\"https://docs.athenahq.ai/api-reference/content/list-content-hub-sheets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Content Hub\",\"item\":\"https://docs.athenahq.ai/api-reference/content/list-content-hub-sheets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Track External URLs\",\"item\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls#apireference\",\"headline\":\"Track External URLs\",\"name\":\"Track External URLs\",\"description\":\"Register existing pages or third-party URLs as tracked Content Hub items so Athena attributes citations and mentions to them. Creates external content rows from bare URLs with no generation and no credit cost. Tracking starts immediately: the normalized URL becomes the citation/metric join key, so pages cited in the website's monitored AI responses accrue metrics with no publish step (use it for guest posts, partner placements, or any page Athena did not generate). Idempotent per URL: a URL already present on the website (any content type) is not duplicated; the response lists it under skipped with the existing content_id and type. Check that type before chaining destructive calls (a skip can resolve to first-party generated content that shares the URL). Rows are created without page text, which citation tracking does not need; the body can be filled from the app later. Duplicate URLs within one call (including tracking-param variants of the same page) collapse to one row, first occurrence wins. Optional sheet_id files rows under a Content Hub tab; view-type tabs resolve to the main pool (null), echoed per row. Optional per-URL fields set the customer's own Content Hub columns on the created row, addressed by column name as shown on the destination tab (text, number, date, checkbox, link, and multi-select columns; unknown multi-select options are created). An unknown column name or a value that does not fit the column type rejects the whole call and nothing is tracked; skipped URLs keep their existing values. Each created and skipped entry includes destination_name and content_hub_url. Share these with the user alongside the created and skipped counts. The link opens the specific item with its website and destination selected. Omitting sheet_id uses the shared pool regardless of the currently open browser tab. A skipped URL remains in its existing tab, even when a different sheet_id was requested.\",\"url\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls\",\"mainEntityOfPage\":{\"@id\":\"https://docs.athenahq.ai/api-reference/content/track-external-urls#webpage\"},\"dateModified\":\"2026-10-27T20:04:57.162Z\",\"publisher\":{\"@id\":\"https://docs.athenahq.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.athenahq.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AthenaHQ\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"AthenaHQ","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/getting-started/setup"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Overview","pages":[{"title":"Introduction","icon":"book","href":"/api-reference/introduction"},{"title":"Authentication","icon":"key","href":"/api-reference/authentication"},{"title":"Single Sign-On (SSO)","icon":"lock","href":"/api-reference/sso"},{"title":"Rate Limits","icon":"gauge","href":"/api-reference/rate-limits"},{"title":"Changelog","icon":"clock-rotate-left","href":"/api-reference/changelog"}]},{"group":"Integrations","pages":[{"title":"MCP Server","icon":"plug","href":"/api-reference/mcp"},{"title":"Looker Studio","icon":"chart-line","href":"/api-reference/looker-studio"},{"title":"Power BI \u0026 Microsoft Fabric","icon":"chart-column","href":"/api-reference/powerbi-fabric"},{"title":"Saved view exports","icon":"file-export","href":"/api-reference/saved-view-exports"}]},{"group":"Core Resources","pages":[{"group":"Utilities","pages":[{"title":"Validate API Key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/validate-api-key","href":"/api-reference/basics/validate-api-key"},{"title":"Get Date Range","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/date-range","href":"/api-reference/basics/get-date-range"},{"title":"Query Looker Studio report data","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/looker-studio/data","href":"/api-reference/analytics/query-looker-studio-report-data"}]},{"group":"Websites","pages":[{"title":"Get Websites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/websites","href":"/api-reference/basics/get-websites"},{"title":"Create Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites","href":"/api-reference/basics/create-website"},{"title":"Provision Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites/provision","href":"/api-reference/basics/provision-website"},{"title":"Update Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/websites/{website_id}","href":"/api-reference/basics/update-website"},{"title":"Delete Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites/{website_id}/delete","href":"/api-reference/basics/delete-website"},{"title":"Restore Website","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/websites/{website_id}/restore","href":"/api-reference/basics/restore-website"}]},{"group":"Prompts","pages":[{"title":"Get Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/prompts","href":"/api-reference/basics/get-prompts"},{"title":"Create Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/prompts","href":"/api-reference/basics/create-prompts"},{"title":"Update Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/prompts/{prompt_id}","href":"/api-reference/basics/update-prompt"},{"title":"Pause or Unpause Prompts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/prompts/status","href":"/api-reference/basics/pause-or-unpause-prompts"},{"title":"Delete Prompt","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/prompts/{prompt_id}","href":"/api-reference/basics/delete-prompt"},{"title":"Get Prompt Tags","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/prompt-tags","href":"/api-reference/basics/get-prompt-tags"},{"title":"List prompt schedules","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/prompt-schedules","href":"/api-reference/basics/list-prompt-schedules"}]},{"group":"API Keys","pages":[{"title":"List API Keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/api-keys","href":"/api-reference/basics/list-api-keys"}]},{"group":"Activity","pages":[{"title":"List Activity","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/activity","href":"/api-reference/basics/list-activity"}]},{"group":"Topics","pages":[{"title":"Get Topics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/topics","href":"/api-reference/basics/get-topics"},{"title":"Create Topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/topics","href":"/api-reference/basics/create-topic"},{"title":"Update Topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/topics/{topic_id}","href":"/api-reference/basics/update-topic"},{"title":"Delete Topic","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/topics/{topic_id}","href":"/api-reference/basics/delete-topic"}]},{"group":"Personas \u0026 Competitors","pages":[{"title":"Get Personas","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/personas","href":"/api-reference/basics/get-personas"},{"title":"Get Competitors","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/competitors","href":"/api-reference/basics/get-competitors"}]},{"group":"Locations","pages":[{"title":"Get Locations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/locations","href":"/api-reference/basics/get-locations"},{"title":"Create Location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/locations","href":"/api-reference/basics/create-location"},{"title":"Update Location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/locations/{location_id}","href":"/api-reference/basics/update-location"},{"title":"Delete Location","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/locations/{location_id}","href":"/api-reference/basics/delete-location"}]},{"group":"Responses","pages":[{"title":"Query Responses","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/responses","href":"/api-reference/basics/query-responses"},{"title":"Start Response Streaming","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/response-streaming/start","href":"/api-reference/basics/start-response-streaming"},{"title":"Get Response Streaming Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/response-streaming/status","href":"/api-reference/basics/get-response-streaming-status"}]},{"group":"Saved Views","pages":[{"title":"Get Saved Views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/saved-views","href":"/api-reference/basics/get-saved-views"},{"title":"Get Group Saved Views","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/group-saved-views","href":"/api-reference/basics/get-group-saved-views"}]}]},{"group":"Analytics","pages":[{"group":"Attributes","pages":[{"title":"List Attributes","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/attributes","href":"/api-reference/attributes/list-attributes"},{"title":"Cumulative Attribute Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/cumulative","href":"/api-reference/attributes/cumulative-attribute-metrics"},{"title":"Competitor Attribute Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/competitors","href":"/api-reference/attributes/competitor-attribute-metrics"},{"title":"Attribute Time Series","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/time-series","href":"/api-reference/attributes/attribute-time-series"},{"title":"Attribute Observations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/attributes/observations","href":"/api-reference/attributes/attribute-observations"}]},{"group":"Share of Voice","pages":[{"title":"Cumulative Share of Voice","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/share-of-voice/cumulative","href":"/api-reference/metrics/cumulative-share-of-voice"},{"title":"Share of Voice Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/share-of-voice/time-series","href":"/api-reference/metrics/share-of-voice-over-time"}]},{"group":"Mention Rate","pages":[{"title":"Cumulative Mention Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/mention-rate/cumulative","href":"/api-reference/metrics/cumulative-mention-rate"},{"title":"Mention Rate Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/mention-rate/time-series","href":"/api-reference/metrics/mention-rate-over-time"}]},{"group":"Citation Rate","pages":[{"title":"Cumulative Citation Rate","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/citation-rate/cumulative","href":"/api-reference/metrics/cumulative-citation-rate"},{"title":"Citation Rate Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/citation-rate/time-series","href":"/api-reference/metrics/citation-rate-over-time"}]},{"group":"Position","pages":[{"title":"Cumulative Position","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/position/cumulative","href":"/api-reference/metrics/cumulative-position"},{"title":"Position Over Time","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/position/time-series","href":"/api-reference/metrics/position-over-time"}]},{"group":"Shopping","pages":[{"title":"Shopping Metrics","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/metrics/shopping","href":"/api-reference/metrics/shopping-metrics"}]},{"group":"AI Search Value","pages":[{"title":"AI Search Value","icon":"money-bill-trend-up","href":"/api-reference/ai-search-value"},{"title":"Get AI Search Value","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/ai-search-value","href":"/api-reference/ai-search-value/get-ai-search-value"}]}]},{"group":"Content \u0026 Knowledge","pages":[{"group":"Content Hub","pages":[{"title":"List Content Hub Sheets","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/sheets","href":"/api-reference/content/list-content-hub-sheets"},{"title":"List Tracked Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content","href":"/api-reference/content/list-tracked-content"},{"title":"List Content Items","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/items","href":"/api-reference/content/list-content-items"},{"title":"Get Content Detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}","href":"/api-reference/content/get-content-detail"},{"title":"Per-Content Prompt Citation Breakdown","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/prompts","href":"/api-reference/content/per-content-prompt-citation-breakdown"},{"title":"Start Content Pipeline","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/generate","href":"/api-reference/content/start-content-pipeline"},{"title":"Get Content Pipeline Status","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}/status","href":"/api-reference/content/get-content-pipeline-status"},{"title":"Get Content Draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}/draft","href":"/api-reference/content/get-content-draft"},{"title":"Revise Content Brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/brief/revise","href":"/api-reference/content/revise-content-brief"},{"title":"Approve Content Brief","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/brief/approve","href":"/api-reference/content/approve-content-brief"},{"title":"Revise Content Draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/revise","href":"/api-reference/content/revise-content-draft"},{"title":"Edit Content Draft","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/edit","href":"/api-reference/content/edit-content-draft"},{"title":"List Content Versions","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/versions","href":"/api-reference/content/list-content-versions"},{"title":"Get Content Version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/content/{content_id}/versions/{version_id}","href":"/api-reference/content/get-content-version"},{"title":"Restore Content Version","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/versions/{version_id}/restore","href":"/api-reference/content/restore-content-version"},{"title":"Mark Content as Published","description":"Record an already-published article's URL in AthenaHQ for citation and mention tracking. Does not upload or publish content to a website or CMS. Call only after the article is live. Sets the first publication time and moves the pipeline stage to done. A first publish requires a finished article (stage generated), with one exception: an optimize draft is created from a page that is already live and can be marked published while it waits at stage pending, as long as no Athena review is running on it. Briefs, still-generating or failed pieces, optimize drafts with a review in flight, and items with a scheduled CMS publish are rejected with 409 and the reason. Pass the exact public URL of the live page (a bare domain path like acme.com/blog/post is fine; the protocol is stripped on store). Calling it again on an already-published item (including external and imported pages, which are live by definition) updates the tracked URL only, keeping the original publish time. This is the only way to set a content URL over the API; the rename endpoint is deliberately title-only.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/{content_id}/publish","href":"/api-reference/content/mark-content-as-published"},{"title":"Track External URLs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/content/track","href":"/api-reference/content/track-external-urls"},{"title":"Rename Content","description":"Rename a content row's title. URL editing is not supported — URL is the content asset's stable identity and cannot be changed here.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/content/{content_id}","href":"/api-reference/content/rename-content"},{"title":"Delete Content","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/content/{content_id}","href":"/api-reference/content/delete-content"}]},{"group":"SEO Recommendations","pages":[{"title":"Submit SEO recommendations","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/seo/recommendations","href":"/api-reference/seo-recommendations/submit-seo-recommendations"},{"title":"Get SEO recommendation job","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/seo/recommendations/{job_id}","href":"/api-reference/seo-recommendations/get-seo-recommendation-job"}]},{"group":"Knowledge Base","pages":[{"title":"Search Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/facts/search","href":"/api-reference/knowledge-base/search-brand-facts"},{"title":"Get Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/facts","href":"/api-reference/knowledge-base/get-brand-facts"},{"title":"Get Pillars","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/pillars","href":"/api-reference/knowledge-base/get-pillars"},{"title":"Get Pillar Document","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/knowledge-base/pillars/{pillar_id}/document","href":"/api-reference/knowledge-base/get-pillar-document"},{"title":"Add Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/facts","href":"/api-reference/knowledge-base/add-brand-facts"},{"title":"Update Brand Fact","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge-base/facts/{fact_id}","href":"/api-reference/knowledge-base/update-brand-fact"},{"title":"Delete Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/facts/delete","href":"/api-reference/knowledge-base/delete-brand-facts"},{"title":"Move Brand Facts","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/facts/move","href":"/api-reference/knowledge-base/move-brand-facts"},{"title":"Create Pillar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/pillars","href":"/api-reference/knowledge-base/create-pillar"},{"title":"Update Pillar","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/knowledge-base/pillars/{pillar_id}","href":"/api-reference/knowledge-base/update-pillar"},{"title":"Delete Pillars","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/pillars/delete","href":"/api-reference/knowledge-base/delete-pillars"},{"title":"Merge Pillars","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/knowledge-base/pillars/merge","href":"/api-reference/knowledge-base/merge-pillars"}]},{"group":"Pitch Workspace","pages":[{"title":"Create a pitch report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/pitches","href":"/api-reference/pitch-workspace/create-a-pitch-report"},{"title":"List Pitches","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/pitches","href":"/api-reference/pitch-workspace/list-pitches"},{"title":"Get Pitch Report","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/pitches/{pitch_id}","href":"/api-reference/pitch-workspace/get-pitch-report"}]},{"group":"Sources","pages":[{"title":"List Sources (by root domain)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/sources","href":"/api-reference/sources/list-sources-by-root-domain"},{"title":"List Source Pages (per URL)","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/source-pages","href":"/api-reference/sources/list-source-pages-per-url"}]}]},{"group":"Administration","pages":[{"group":"Groups","pages":[{"title":"List Groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/groups","href":"/api-reference/groups/list-groups"},{"title":"Create Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/groups","href":"/api-reference/groups/create-group"},{"title":"Get Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/groups/{group_id}","href":"/api-reference/groups/get-group"},{"title":"Update Group","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/groups/{group_id}","href":"/api-reference/groups/update-group"}]},{"group":"Invites","pages":[{"title":"Create Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/invites","href":"/api-reference/team-management/create-invite"},{"title":"Bulk Invite to Websites or Groups","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/invites/bulk","href":"/api-reference/team-management/bulk-invite-to-websites-or-groups"},{"title":"Revoke Organization Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/invites/org/{invite_id}","href":"/api-reference/team-management/revoke-organization-invite"},{"title":"Revoke Website Invite","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/invites/website/{invite_id}","href":"/api-reference/team-management/revoke-website-invite"}]},{"group":"Members","pages":[{"title":"List Organization Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/organizations/members","href":"/api-reference/team-management/list-organization-members"},{"title":"List Website Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/websites/{website_id}/members","href":"/api-reference/team-management/list-website-members"},{"title":"List Group Members","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/groups/{group_id}/members","href":"/api-reference/team-management/list-group-members"},{"title":"Look Up User By Email","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/users/by-email","href":"/api-reference/team-management/look-up-user-by-email"},{"title":"List User Websites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/users/{user_id}/websites","href":"/api-reference/team-management/list-user-websites"},{"title":"Remove User From Websites","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/users/{user_id}/websites","href":"/api-reference/team-management/remove-user-from-websites"},{"title":"Update Organization Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/organizations/members/{user_id}","href":"/api-reference/team-management/update-organization-member-role"},{"title":"Update Website Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/websites/{website_id}/members/{user_id}","href":"/api-reference/team-management/update-website-member-role"},{"title":"Update Group Member Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/groups/{group_id}/members/{user_id}","href":"/api-reference/team-management/update-group-member-role"},{"title":"Remove Group Member Access","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/groups/{group_id}/members/{user_id}","href":"/api-reference/team-management/remove-group-member-access"},{"title":"Remove Organization Member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/organizations/members/{user_id}","href":"/api-reference/team-management/remove-organization-member"},{"title":"Remove Website Member","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/websites/{website_id}/members/{user_id}","href":"/api-reference/team-management/remove-website-member"}]},{"group":"Roles","pages":[{"title":"List Roles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/roles","href":"/api-reference/team-management/list-roles"},{"title":"Create Custom Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/roles","href":"/api-reference/team-management/create-custom-role"},{"title":"Get Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/roles/{role_id}","href":"/api-reference/team-management/get-role"},{"title":"Update Custom Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json patch /api/v1/roles/{role_id}","href":"/api-reference/team-management/update-custom-role"},{"title":"Delete Custom Role","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /api/v1/roles/{role_id}","href":"/api-reference/team-management/delete-custom-role"}]},{"group":"Billing","pages":[{"title":"Get Website Credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/credits/website","href":"/api-reference/billing/get-website-credits"},{"title":"Get Organization Credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/credits/organization","href":"/api-reference/billing/get-organization-credits"},{"title":"Get Group Credits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/credits/group","href":"/api-reference/billing/get-group-credits"},{"title":"Get Website Subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /api/v1/subscriptions/website","href":"/api-reference/billing/get-website-subscription"},{"title":"Cancel Subscription","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/subscriptions/cancel","href":"/api-reference/billing/cancel-subscription"}]},{"group":"AI Access","pages":[{"title":"AI Access","icon":"robot","href":"/api-reference/ai-access"},{"title":"Check AI accessibility for a domain","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /api/v1/ai-access/check","href":"/api-reference/ai-access/check-ai-accessibility-for-a-domain"}]}]}]}]},"title":"Track External URLs - AthenaHQ","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}