Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person’s sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project’s access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects//setup/catalogue/agent-picks lists. A body that isn’t JSON, an email that isn’t an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the setup.write scope.
API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.
Path Parameters
projectId
string<uuid>
required
The project the credential is bound to. Read it from GET /connection.
Body
application/json
email
string<email>
required
The sign-in email of the person who will claim it.
Maximum string length: 320
draft
object
required
An unclaimed agent registration’s project setup, replaced whole. visibility is required for ai-search and both and refused otherwise; agent_picks is required for agent-picks and both and refused otherwise. Probed platforms are not part of a draft. Plan limits are applied when a person claims the registration.
Show child attributes
Response
The started claim
data
object
required
Show child attributes
meta
object
required
Sent beside data on every successful response that returns data.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"DevTune","colors":{"primary":"#2BA673","light":"#3DD68C","dark":"#1E8A5E"},"logo":{"light":"https://mintcdn.com/plgeekltd/9IlfhLPAkzufc-a9/logo/light.svg?fit=max\u0026auto=format\u0026n=9IlfhLPAkzufc-a9\u0026q=85\u0026s=e084324efa0272057bc85d33172080b3","dark":"https://mintcdn.com/plgeekltd/9IlfhLPAkzufc-a9/logo/dark.svg?fit=max\u0026auto=format\u0026n=9IlfhLPAkzufc-a9\u0026q=85\u0026s=18c7dd26606bb9f39f087952f4d6ca57"},"favicon":"https://mintcdn.com/plgeekltd/9IlfhLPAkzufc-a9/favicon.ico?fit=max\u0026auto=format\u0026n=9IlfhLPAkzufc-a9\u0026q=85\u0026s=18557af9b84271b45e33ffe51a1a1826","navbar":{"links":[{"href":"https://devtune.ai/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Go to DevTune","href":"https://devtune.ai"}},"footer":{"socials":{"website":"https://devtune.ai","github":"https://github.com/devtunehq","x":"https://x.com/DevTuneHQ"}},"seo":{},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"plgeekltd","hasAudioNarration":false,"actualSubdomain":"plgeekltd","customDomains":["docs.devtune.ai"],"gitSource":{"type":"github","owner":"devtunehq","repo":"devtuneai","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":false},"entitlements":{},"buildId":"6b034574429c2eb6eb1ac0aa","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"API Reference","count":203},{"language":"default","tag":"Endpoints","count":189},{"language":"default","tag":"Documentation","count":90},{"language":"default","tag":"Agent Picks","count":39},{"language":"default","tag":"AI Traffic","count":35},{"language":"default","tag":"Insights","count":31},{"language":"default","tag":"Visibility","count":27},{"language":"default","tag":"Setup","count":23},{"language":"default","tag":"Agents","count":19},{"language":"default","tag":"Actions","count":18}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/draft-a-new-project-for-a-person-to-claim","slug":"/api-reference/draft-a-new-project-for-a-person-to-claim","pageMetadata":{"title":"Draft a new project for a person to claim","description":"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person's sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project's access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn't JSON, an email that isn't an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the `setup.write` scope.","deprecated":null,"version":null,"sidebarTitle":"Draft a new project for a person to claim","openapi":"/openapi.json post /projects/{projectId}/setup/new-project-draft","href":"/api-reference/draft-a-new-project-for-a-person-to-claim","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 code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person’s sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project’s access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/\", \"/setup/catalogue/agent-picks lists. A body that isn’t JSON, an email that isn’t an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the \", _jsx(_components.code, {\n children: \"setup.write\"\n }), \" scope.\"]\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":"Draft a new project for a person to claim","description":"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person's sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project's access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn't JSON, an email that isn't an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the `setup.write` scope.","deprecated":null,"version":null,"sidebarTitle":"Draft a new project for a person to claim","openapi":"/openapi.json post /projects/{projectId}/setup/new-project-draft","href":"/api-reference/draft-a-new-project-for-a-person-to-claim","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/plgeekltd/71e4b5285c42f79d/analytics.js"],"openApiReferenceData":{"operation":{"summary":"Draft a new project for a person to claim","description":"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person's sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project's access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn't JSON, an email that isn't an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the `setup.write` scope.","operationId":"draftNewProject","security":["5877a14d-960e-4e0d-9cb3-c4b162c80d24","6c0aea23-9671-4911-8b9f-b43a43230345"],"x-devtune-required-scope":"setup.write","parameters":["7e3dec7f-6c6f-4f00-83dc-36e3541aaf93"],"requestBody":"b1cde199-5511-4f5a-9562-dd6701b26103","responses":{"201":"f6cecef8-fa6b-4763-9d84-bbf84fb53e62","400":"7a468962-64d9-45a0-b8a8-8606851e0af9","401":"837658d6-8fbf-4cbb-947d-3e49dae31c10","403":"9a770b7a-2ef2-4f8d-824a-e119f322e586","404":"6564098d-c60c-407e-b469-64e04f04f61e","429":"8387dc78-233f-4bc9-a2d2-eed176fa2211","500":"072df354-cf81-456c-aca7-b0b9be125fff"},"tags":["Setup"],"x-mint":{"href":"/api-reference/draft-a-new-project-for-a-person-to-claim"},"method":"post","type":"path","servers":["6258be60-5d3c-43df-b329-c7c31aac7880"],"path":"/projects/{projectId}/setup/new-project-draft","baseUrlOptions":["https://devtune.ai/api/v2"],"title":"Draft a new project for a person to claim","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7e3dec7f-6c6f-4f00-83dc-36e3541aaf93":{"name":"projectId","in":"path","required":true,"description":"The project the credential is bound to. Read it from GET /connection.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The project the credential is bound to. Read it from GET /connection.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["email","draft"],"properties":{"email":{"type":"string","format":"email","maxLength":320,"description":"The sign-in email of the person who will claim it.","isRequired":true,"uniqueKey":"email","typeLabel":"string\u003cemail>"},"draft":{"type":"object","additionalProperties":false,"required":["product"],"description":"An unclaimed agent registration’s project setup, replaced whole. visibility is required for ai-search and both and refused otherwise; agent_picks is required for agent-picks and both and refused otherwise. Probed platforms are not part of a draft. Plan limits are applied when a person claims the registration.","properties":{"product":{"description":"What the project is set up for: ai-search, agent-picks or both.","type":"string","enum":["ai-search","agent-picks","both"],"isRequired":true,"uniqueKey":"draft.product","typeLabel":"enum\u003cstring>"},"trial_plan":{"oneOf":[{"type":"string","description":"The Agent Picks plan a new account’s trial starts on: local-runner (Local Runner monthly) or a Local Runner price id, at one project and with no units; cloud (Cloud monthly at 100 credits), a Cloud price id, or a Cloud price id and its units of 20 credits, such as price_…:9 for 180 credits. The retired plus and pro, and their price ids, select Cloud at 100 and 180 credits. Rejected for ai-search. For agent-picks a new account’s trial starts on it; for both it is accepted but not used. Null when none is chosen.","uniqueKey":"draft.trial_plan.oneOf.0","typeLabel":"string"},{"type":"null","description":"The Agent Picks plan a new account’s trial starts on: local-runner (Local Runner monthly) or a Local Runner price id, at one project and with no units; cloud (Cloud monthly at 100 credits), a Cloud price id, or a Cloud price id and its units of 20 credits, such as price_…:9 for 180 credits. The retired plus and pro, and their price ids, select Cloud at 100 and 180 credits. Rejected for ai-search. For agent-picks a new account’s trial starts on it; for both it is accepted but not used. Null when none is chosen.","uniqueKey":"draft.trial_plan.oneOf.1","typeLabel":"null"}],"uniqueKey":"draft.trial_plan","typeLabel":"string | null"},"visibility":{"oneOf":[{"description":"The AI search setup. Null unless product is ai-search or both.","type":"object","additionalProperties":false,"required":["domain"],"properties":{"domain":{"type":"string","minLength":1,"maxLength":2048,"description":"The project's website domain.","isRequired":true,"uniqueKey":"draft.visibility.oneOf.0.domain","typeLabel":"string"},"brand_context":{"oneOf":[{"description":"A description of the company. Null when none is given.","type":"string","minLength":20,"maxLength":10000,"uniqueKey":"draft.visibility.oneOf.0.brand_context.oneOf.0","typeLabel":"string"},{"description":"A description of the company. Null when none is given.","type":"null","minLength":20,"maxLength":10000,"uniqueKey":"draft.visibility.oneOf.0.brand_context.oneOf.1","typeLabel":"null"}],"uniqueKey":"draft.visibility.oneOf.0.brand_context","typeLabel":"string | null"},"competitors":{"type":"array","maxItems":25,"description":"Under both, the one competitor list both products share.","items":{"type":"object","additionalProperties":false,"required":["name","urls"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"draft.visibility.oneOf.0.competitors.items.[INDEX].name","typeLabel":"string"},"urls":{"description":"The competitor's website URLs.","type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":2048,"uniqueKey":"draft.visibility.oneOf.0.competitors.items.[INDEX].urls.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"draft.visibility.oneOf.0.competitors.items.[INDEX].urls","typeLabel":"string[]"}},"uniqueKey":"draft.visibility.oneOf.0.competitors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"draft.visibility.oneOf.0.competitors","typeLabel":"object[]"},"prompts":{"description":"Prompts to track, as written.","type":"array","maxItems":50,"items":{"type":"string","minLength":10,"maxLength":1000,"uniqueKey":"draft.visibility.oneOf.0.prompts.items.[INDEX]","typeLabel":"string"},"uniqueKey":"draft.visibility.oneOf.0.prompts","typeLabel":"string[]"}},"uniqueKey":"draft.visibility.oneOf.0","typeLabel":"object"},{"description":"The AI search setup. Null unless product is ai-search or both.","type":"null","additionalProperties":false,"required":["domain"],"properties":{"domain":{"type":"string","minLength":1,"maxLength":2048,"description":"The project's website domain."},"brand_context":{"oneOf":[{"description":"A description of the company. Null when none is given.","type":"string","minLength":20,"maxLength":10000},{"description":"A description of the company. Null when none is given.","type":"null","minLength":20,"maxLength":10000}]},"competitors":{"type":"array","maxItems":25,"description":"Under both, the one competitor list both products share.","items":{"type":"object","additionalProperties":false,"required":["name","urls"],"properties":{"name":{"type":"string","minLength":1,"maxLength":100},"urls":{"description":"The competitor's website URLs.","type":"array","minItems":1,"maxItems":10,"items":{"type":"string","minLength":1,"maxLength":2048}}}}},"prompts":{"description":"Prompts to track, as written.","type":"array","maxItems":50,"items":{"type":"string","minLength":10,"maxLength":1000}}},"uniqueKey":"draft.visibility.oneOf.1","typeLabel":"null"}],"uniqueKey":"draft.visibility","typeLabel":"object | null"},"agent_picks":{"oneOf":[{"type":"object","description":"The Agent Picks setup: a public category's setup (use_category) or the project's own job (start_from_scratch). Null unless product is agent-picks or both.","required":["starting_point","setup"],"properties":{"starting_point":{"type":"string","const":"use_category","isRequired":true,"uniqueKey":"draft.agent_picks.oneOf.0.starting_point","typeLabel":"string"},"setup":{"type":"object","description":"The body saveAgentPicksSetup accepts, with ids from getPublicAgentPicksCatalogue.","isRequired":true,"uniqueKey":"draft.agent_picks.oneOf.0.setup","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"draft.agent_picks.oneOf.0","typeLabel":"object"},{"type":"object","description":"The Agent Picks setup: a public category's setup (use_category) or the project's own job (start_from_scratch). Null unless product is agent-picks or both.","required":["starting_point","job"],"properties":{"starting_point":{"type":"string","const":"start_from_scratch","isRequired":true,"uniqueKey":"draft.agent_picks.oneOf.1.starting_point","typeLabel":"string"},"job":{"type":"object","description":"The body saveAgentPicksJob accepts, with ids from getPublicAgentPicksCatalogue.","isRequired":true,"uniqueKey":"draft.agent_picks.oneOf.1.job","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"draft.agent_picks.oneOf.1","typeLabel":"object"},{"type":"null","uniqueKey":"draft.agent_picks.oneOf.2","typeLabel":"null"}],"uniqueKey":"draft.agent_picks","typeLabel":"object · object · null"}},"isRequired":true,"uniqueKey":"draft","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"email":"[email protected]","draft":{"trial_plan":"\u003cstring>","visibility":{"domain":"\u003cstring>","brand_context":"\u003cstring>","competitors":[{"name":"\u003cstring>","urls":["\u003cstring>"]}],"prompts":["\u003cstring>"]},"agent_picks":{"starting_point":"use_category","setup":{}}}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f6cecef8-fa6b-4763-9d84-bbf84fb53e62":{"description":"The started claim","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":false,"required":["registration_id","claim_token","claim_token_expires","claim_attempt","claim_url","token_endpoint","grant_type","post_claim_scopes"],"properties":{"registration_id":{"type":"string","description":"The agent registration holding the draft.","isRequired":true,"uniqueKey":"data.registration_id","typeLabel":"string"},"claim_token":{"type":"string","description":"The secret the agent polls the token endpoint with, and restarts the claim with. Returned only in this response.","isRequired":true,"uniqueKey":"data.claim_token","typeLabel":"string"},"claim_token_expires":{"type":"string","format":"date-time","description":"When the unclaimed registration and its draft expire.","isRequired":true,"uniqueKey":"data.claim_token_expires","typeLabel":"string\u003cdate-time>"},"claim_attempt":{"type":"object","additionalProperties":false,"required":["user_code","verification_uri","expires_in","interval"],"description":"What the person needs to claim the draft.","properties":{"user_code":{"type":"string","description":"The code the person types on the claim page.","isRequired":true,"uniqueKey":"data.claim_attempt.user_code","typeLabel":"string"},"verification_uri":{"type":"string","format":"uri","description":"The claim page link, through sign-in with the email given.","isRequired":true,"uniqueKey":"data.claim_attempt.verification_uri","typeLabel":"string\u003curi>"},"expires_in":{"type":"integer","description":"Seconds until the code expires. Restart the claim at claim_url for a new one.","isRequired":true,"uniqueKey":"data.claim_attempt.expires_in","typeLabel":"integer"},"interval":{"type":"integer","description":"The fewest seconds between polls of the token endpoint.","isRequired":true,"uniqueKey":"data.claim_attempt.interval","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"data.claim_attempt","typeLabel":"object"},"claim_url":{"type":"string","format":"uri","description":"Where to POST claim_token and email for a new code once this one expires.","isRequired":true,"uniqueKey":"data.claim_url","typeLabel":"string\u003curi>"},"token_endpoint":{"type":"string","format":"uri","description":"Where to poll with grant_type and claim_token. It answers authorization_pending until the person confirms, then returns an access token for the new project.","isRequired":true,"uniqueKey":"data.token_endpoint","typeLabel":"string\u003curi>"},"grant_type":{"type":"string","enum":["urn:workos:agent-auth:grant-type:claim"],"isRequired":true,"uniqueKey":"data.grant_type","typeLabel":"enum\u003cstring>"},"post_claim_scopes":{"type":"array","items":{"type":"string","uniqueKey":"data.post_claim_scopes.items.[INDEX]","typeLabel":"string"},"description":"The scopes the new project's key can hold; the claim grants the subset the person's plan offers.","isRequired":true,"uniqueKey":"data.post_claim_scopes","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","description":"Sent beside data on every successful response that returns data.","properties":{"timestamp":{"type":"string","format":"date-time","description":"When the response was produced.","uniqueKey":"meta.timestamp","typeLabel":"string\u003cdate-time>"},"projectId":{"type":"string","format":"uuid","uniqueKey":"meta.projectId","typeLabel":"string\u003cuuid>"}},"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["data","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"registration_id":"\u003cstring>","claim_token":"\u003cstring>","claim_token_expires":"2023-11-07T05:31:56Z","claim_attempt":{"user_code":"\u003cstring>","verification_uri":"\u003cstring>","expires_in":123,"interval":123},"claim_url":"\u003cstring>","token_endpoint":"\u003cstring>","grant_type":"urn:workos:agent-auth:grant-type:claim","post_claim_scopes":["\u003cstring>"]},"meta":{"timestamp":"2023-11-07T05:31:56Z","projectId":"3c90c3cc-0d44-4b50-8888-8dd25736052a"}}}},"exampleType":"generated"}},"exampleType":"generated"},"7a468962-64d9-45a0-b8a8-8606851e0af9":{"description":"The request is invalid: a parameter or body field is missing, has the wrong type or is out of range, or a cursor doesn't match this list. The message says which; reason, where present, is listed in the endpoint's description. Fix the request before retrying, and restart a list without its cursor. See [Errors](/api-reference/errors).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code, such as bad_request, unauthorized, forbidden, not_found, conflict, payment_required, rate_limit_exceeded or internal_error. Some endpoints return their own codes, listed in their descriptions.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"What went wrong, for a person to read. Do not parse it; use error and reason.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the failure or refusal, such as retryable or shortfall_credits.","properties":{"retryable":{"type":"boolean","description":"Read this field before retrying. Present on every 5xx and 429 response: true when another attempt may succeed, false for a permanent refusal even on a 5xx. Other refusals may also provide this field.","uniqueKey":"details.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Seconds to wait when retryable is true on a 429 or 503 response, also sent in Retry-After. Uses the provider retry time or limiter reset when available; otherwise 60 seconds for 429 and GitHub throttles or 30 seconds for other 503 responses. GitHub secondary limits wait at least 60 seconds.","uniqueKey":"details.retryAfterSeconds","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{"retryable":true,"retryAfterSeconds":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"837658d6-8fbf-4cbb-947d-3e49dae31c10":{"description":"The request has no valid credential: the Authorization header is missing or malformed, or the API key or OAuth token is invalid, expired or revoked. Send `Authorization: Bearer \u003cAPI key>` with an active key, or sign in again to get a new OAuth token. See [Errors](/api-reference/errors).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code, such as bad_request, unauthorized, forbidden, not_found, conflict, payment_required, rate_limit_exceeded or internal_error. Some endpoints return their own codes, listed in their descriptions.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"What went wrong, for a person to read. Do not parse it; use error and reason.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the failure or refusal, such as retryable or shortfall_credits.","properties":{"retryable":{"type":"boolean","description":"Read this field before retrying. Present on every 5xx and 429 response: true when another attempt may succeed, false for a permanent refusal even on a 5xx. Other refusals may also provide this field.","uniqueKey":"details.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Seconds to wait when retryable is true on a 429 or 503 response, also sent in Retry-After. Uses the provider retry time or limiter reset when available; otherwise 60 seconds for 429 and GitHub throttles or 30 seconds for other 503 responses. GitHub secondary limits wait at least 60 seconds.","uniqueKey":"details.retryAfterSeconds","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{"retryable":true,"retryAfterSeconds":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"9a770b7a-2ef2-4f8d-824a-e119f322e586":{"description":"The credential is valid but can't make this request. The message says which cause applies: the key or sign-in lacks the scope this endpoint requires (named in the message), it belongs to another project, the plan doesn't include API access or this feature, the project is paused (a paused project keeps only read scopes and setup.write), or the member a write acts as no longer has the role it needs. Read `GET /projects/{projectId}/connection` for the credential's current scopes and features, then use a key that has the scope, sign in again and approve it, or upgrade the plan. See [Errors](/api-reference/errors).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code, such as bad_request, unauthorized, forbidden, not_found, conflict, payment_required, rate_limit_exceeded or internal_error. Some endpoints return their own codes, listed in their descriptions.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"What went wrong, for a person to read. Do not parse it; use error and reason.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the failure or refusal, such as retryable or shortfall_credits.","properties":{"retryable":{"type":"boolean","description":"Read this field before retrying. Present on every 5xx and 429 response: true when another attempt may succeed, false for a permanent refusal even on a 5xx. Other refusals may also provide this field.","uniqueKey":"details.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Seconds to wait when retryable is true on a 429 or 503 response, also sent in Retry-After. Uses the provider retry time or limiter reset when available; otherwise 60 seconds for 429 and GitHub throttles or 30 seconds for other 503 responses. GitHub secondary limits wait at least 60 seconds.","uniqueKey":"details.retryAfterSeconds","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{"retryable":true,"retryAfterSeconds":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"6564098d-c60c-407e-b469-64e04f04f61e":{"description":"The resource doesn't exist in this project, was deleted, or the credential can't see it. Check the IDs in the path, and that the projectId is the project the credential is bound to. See [Errors](/api-reference/errors).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code, such as bad_request, unauthorized, forbidden, not_found, conflict, payment_required, rate_limit_exceeded or internal_error. Some endpoints return their own codes, listed in their descriptions.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"What went wrong, for a person to read. Do not parse it; use error and reason.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the failure or refusal, such as retryable or shortfall_credits.","properties":{"retryable":{"type":"boolean","description":"Read this field before retrying. Present on every 5xx and 429 response: true when another attempt may succeed, false for a permanent refusal even on a 5xx. Other refusals may also provide this field.","uniqueKey":"details.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Seconds to wait when retryable is true on a 429 or 503 response, also sent in Retry-After. Uses the provider retry time or limiter reset when available; otherwise 60 seconds for 429 and GitHub throttles or 30 seconds for other 503 responses. GitHub secondary limits wait at least 60 seconds.","uniqueKey":"details.retryAfterSeconds","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{"retryable":true,"retryAfterSeconds":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"8387dc78-233f-4bc9-a2d2-eed176fa2211":{"description":"Too many requests from this credential in the current window. The request was refused before it took effect, so it is safe to retry: wait the seconds in Retry-After, then send it again. Endpoints that start agent runs have a stricter limit. See [Rate limits](/api-reference/rate-limits).","headers":{"Retry-After":{"description":"Seconds to wait before retrying a 429 or retryable 503 response.","schema":{"type":"integer","minimum":1}},"X-RateLimit-Limit":{"description":"Maximum requests per window","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Requests remaining in current window","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Unix timestamp when the window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code, such as bad_request, unauthorized, forbidden, not_found, conflict, payment_required, rate_limit_exceeded or internal_error. Some endpoints return their own codes, listed in their descriptions.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"What went wrong, for a person to read. Do not parse it; use error and reason.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the failure or refusal, such as retryable or shortfall_credits.","properties":{"retryable":{"type":"boolean","description":"Read this field before retrying. Present on every 5xx and 429 response: true when another attempt may succeed, false for a permanent refusal even on a 5xx. Other refusals may also provide this field.","uniqueKey":"details.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Seconds to wait when retryable is true on a 429 or 503 response, also sent in Retry-After. Uses the provider retry time or limiter reset when available; otherwise 60 seconds for 429 and GitHub throttles or 30 seconds for other 503 responses. GitHub secondary limits wait at least 60 seconds.","uniqueKey":"details.retryAfterSeconds","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{"retryable":true,"retryAfterSeconds":2}}}},"exampleType":"generated"}},"exampleType":"generated"},"072df354-cf81-456c-aca7-b0b9be125fff":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Machine-readable error code, such as bad_request, unauthorized, forbidden, not_found, conflict, payment_required, rate_limit_exceeded or internal_error. Some endpoints return their own codes, listed in their descriptions.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"type":"string","description":"What went wrong, for a person to read. Do not parse it; use error and reason.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"integer","description":"The HTTP status code, repeated in the body.","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"reason":{"type":"string","description":"Why the request was refused, for an error with more than one cause, such as a refused content-draft start.","uniqueKey":"reason","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"description":"Machine-readable facts about the failure or refusal, such as retryable or shortfall_credits.","properties":{"retryable":{"type":"boolean","description":"Read this field before retrying. Present on every 5xx and 429 response: true when another attempt may succeed, false for a permanent refusal even on a 5xx. Other refusals may also provide this field.","uniqueKey":"details.retryable","typeLabel":"boolean"},"retryAfterSeconds":{"type":"integer","minimum":1,"description":"Seconds to wait when retryable is true on a 429 or 503 response, also sent in Retry-After. Uses the provider retry time or limiter reset when available; otherwise 60 seconds for 429 and GitHub throttles or 30 seconds for other 503 responses. GitHub secondary limits wait at least 60 seconds.","uniqueKey":"details.retryAfterSeconds","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"}},"required":["error","message","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","message":"\u003cstring>","status":123,"reason":"\u003cstring>","details":{"retryable":true,"retryAfterSeconds":2}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5877a14d-960e-4e0d-9cb3-c4b162c80d24":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.","scopes":[],"schemeName":"bearerAuth"}},"6c0aea23-9671-4911-8b9f-b43a43230345":{"oauthBearer":{"type":"http","scheme":"bearer","description":"Project-granted OAuth access token from the authorization server advertised at /.well-known/oauth-protected-resource/api/v2. Uses the same browser consent and current project permissions as MCP. Only operations explicitly listing oauthBearer accept these tokens.","scopes":[],"schemeName":"oauthBearer"}}},"servers":{"6258be60-5d3c-43df-b329-c7c31aac7880":{"url":"https://devtune.ai/api/v2","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Project-granted OAuth access token from the authorization server advertised at /.well-known/oauth-protected-resource/api/v2. Uses the same browser consent and current project permissions as MCP. Only operations explicitly listing oauthBearer accept these tokens.","scopes":[],"schemeName":"oauthBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Project-granted OAuth access token from the authorization server advertised at /.well-known/oauth-protected-resource/api/v2. Uses the same browser consent and current project permissions as MCP. Only operations explicitly listing oauthBearer accept these tokens.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauthBearer","name":"Authorization"}],"title":"oauthBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"plgeekltd","siteName":"DevTune","title":"Draft a new project for a person to claim - DevTune","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-22T19:41:48.542Z","originalFileLocation":"api-reference/draft-a-new-project-for-a-person-to-claim.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=\"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person\u0026#x27;s sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project\u0026#x27;s access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn\u0026#x27;t JSON, an email that isn\u0026#x27;t an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the setup.write scope.\">\u003cmeta data-mint-head name=\"application-name\" content=\"DevTune\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_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/plgeekltd/AeypV2Tr2kGE7goT/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Draft a new project for a person to claim - DevTune\">\u003cmeta data-mint-head property=\"og:description\" content=\"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person\u0026#x27;s sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project\u0026#x27;s access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn\u0026#x27;t JSON, an email that isn\u0026#x27;t an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the setup.write scope.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"DevTune\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://plgeekltd.mintlify.site/_mintlify/api/og/v2?division=Setup\u0026amp;title=Draft+a+new+project+for+a+person+to+claim\u0026amp;description=Starts+the+auth.md+registration+and+claim+from+this+connection%2C+for+another+product+or+brand%3A+the+credential+stays+bound+to+its+own+project.+Takes+the+person%27s+\u0026amp;theme=6cd2f000e46751de6b3df2e6\u0026amp;signature=0a84cb6e951d4d46a74ce3a24741ca6b295508a8a0c3650a08c45d8148445263\">\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=\"Draft a new project for a person to claim - DevTune\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person\u0026#x27;s sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project\u0026#x27;s access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn\u0026#x27;t JSON, an email that isn\u0026#x27;t an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the setup.write scope.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://plgeekltd.mintlify.site/_mintlify/api/og/v2?division=Setup\u0026amp;title=Draft+a+new+project+for+a+person+to+claim\u0026amp;description=Starts+the+auth.md+registration+and+claim+from+this+connection%2C+for+another+product+or+brand%3A+the+credential+stays+bound+to+its+own+project.+Takes+the+person%27s+\u0026amp;theme=6cd2f000e46751de6b3df2e6\u0026amp;signature=0a84cb6e951d4d46a74ce3a24741ca6b295508a8a0c3650a08c45d8148445263\">\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/plgeekltd/AeypV2Tr2kGE7goT/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"DevTune\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2BA673\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/draft-a-new-project-for-a-person-to-claim.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.devtune.ai/#organization\",\"name\":\"DevTune\",\"url\":\"https://docs.devtune.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/plgeekltd/9IlfhLPAkzufc-a9/logo/light.svg?fit=max\u0026auto=format\u0026n=9IlfhLPAkzufc-a9\u0026q=85\u0026s=e084324efa0272057bc85d33172080b3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.devtune.ai#website\",\"name\":\"DevTune\",\"url\":\"https://docs.devtune.ai\",\"publisher\":{\"@id\":\"https://docs.devtune.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim#webpage\",\"url\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim\",\"name\":\"Draft a new project for a person to claim\",\"description\":\"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person's sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project's access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn't JSON, an email that isn't an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the setup.write scope.\",\"dateModified\":\"2026-11-22T19:41:48.542Z\",\"isPartOf\":{\"@id\":\"https://docs.devtune.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.devtune.ai/api-reference/discover-the-authorized-project\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Setup\",\"item\":\"https://docs.devtune.ai/api-reference/list-brands\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Draft a new project for a person to claim\",\"item\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim#apireference\",\"headline\":\"Draft a new project for a person to claim\",\"name\":\"Draft a new project for a person to claim\",\"description\":\"Starts the auth.md registration and claim from this connection, for another product or brand: the credential stays bound to its own project. Takes the person's sign-in email and a whole setup draft, in the shape PUT /agent/setup-draft takes. No project exists and nothing is spent until the person claims it. Give the person claim_attempt.verification_uri and claim_attempt.user_code; they sign in with that email, review the draft on the claim page and confirm it into their account, where plan limits are applied. Poll token_endpoint with grant_type and claim_token for the new project's access token. The draft cannot be read or changed afterwards; another call starts a second registration. Agent Picks ids must be ones GET /projects/{projectId}/setup/catalogue/agent-picks lists. A body that isn't JSON, an email that isn't an address or a field other than email and draft is 400 bad_request; a missing or invalid draft is 400 invalid_draft. A sixth call within an hour from the calling project is 429 rate_limit_exceeded, with details.retryAt and Retry-After. On that draft-window 429, X-RateLimit-Limit is 5, X-RateLimit-Remaining is 0 and X-RateLimit-Reset is the draft window reset as Unix epoch seconds. Successful drafts keep the credential quota headers. Writes nothing when refused. Requires the setup.write scope.\",\"url\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim\",\"mainEntityOfPage\":{\"@id\":\"https://docs.devtune.ai/api-reference/draft-a-new-project-for-a-person-to-claim#webpage\"},\"dateModified\":\"2026-11-22T19:41:48.542Z\",\"publisher\":{\"@id\":\"https://docs.devtune.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.devtune.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"DevTune\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"DevTune\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/draft-a-new-project-for-a-person-to-claim.md","siteName":"DevTune","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"REST API reference","href":"/api-reference/overview"},{"title":"Prompt-set analysis API and MCP","href":"/api-reference/prompt-set-analysis"},{"title":"API authentication","href":"/api-reference/authentication"},{"title":"Human approval","href":"/api-reference/human-approval"},{"title":"Agent Registration","href":"/api-reference/agent-registration"},{"title":"Try the demo","href":"/api-reference/demo"},{"title":"API Rate Limits","href":"/api-reference/rate-limits"},{"title":"API errors","href":"/api-reference/errors"},{"title":"Probe health","href":"/api-reference/probe-health"}]},{"group":"MCP and webhooks","pages":[{"title":"MCP server","href":"/api-reference/mcp-server"},{"title":"Code mode operations","href":"/api-reference/mcp-code-mode"},{"title":"Webhooks","href":"/api-reference/webhooks"}]},{"group":"SDKs","pages":[{"title":"TypeScript client","href":"/sdk/typescript"},{"title":"CLI","href":"/sdk/cli"}]},{"group":"Endpoints","pages":[{"group":"Connection and usage","pages":[{"title":"Discover the authorized project","deprecated":null,"version":null,"sidebarTitle":"Discover the authorized project","openapi":"/openapi.json get /connection","href":"/api-reference/discover-the-authorized-project"},{"title":"Get the connection context","deprecated":null,"version":null,"sidebarTitle":"Get the connection context","openapi":"/openapi.json get /projects/{projectId}/connection","href":"/api-reference/get-the-connection-context"},{"title":"Revoke the calling API key","deprecated":null,"version":null,"sidebarTitle":"Revoke the calling api key","openapi":"/openapi.json delete /projects/{projectId}/connection/key","href":"/api-reference/revoke-the-calling-api-key"},{"title":"Rotate the calling API key","deprecated":null,"version":null,"sidebarTitle":"Rotate the calling api key","openapi":"/openapi.json post /projects/{projectId}/connection/key/rotate","href":"/api-reference/rotate-the-calling-api-key"},{"title":"Get project status and usage","deprecated":null,"version":null,"sidebarTitle":"Get project status and usage","openapi":"/openapi.json get /projects/{projectId}/usage","href":"/api-reference/get-project-status-and-usage"},{"title":"Get code-mode operation receipts","deprecated":null,"version":null,"sidebarTitle":"Get code mode operation receipts","openapi":"/openapi.json get /projects/{projectId}/code-mode/executions/{executionId}","href":"/api-reference/get-code-mode-operation-receipts"}]},{"group":"Setup","pages":[{"title":"List brands","deprecated":null,"version":null,"sidebarTitle":"List brands","openapi":"/openapi.json get /projects/{projectId}/setup/brands","href":"/api-reference/list-brands"},{"title":"Create a brand","deprecated":null,"version":null,"sidebarTitle":"Create a brand","openapi":"/openapi.json post /projects/{projectId}/setup/brands","href":"/api-reference/create-a-brand"},{"title":"Update a brand","deprecated":null,"version":null,"sidebarTitle":"Update a brand","openapi":"/openapi.json patch /projects/{projectId}/setup/brands/{brandId}","href":"/api-reference/update-a-brand"},{"title":"Archive a brand","deprecated":null,"version":null,"sidebarTitle":"Archive a brand","openapi":"/openapi.json delete /projects/{projectId}/setup/brands/{brandId}","href":"/api-reference/archive-a-brand"},{"title":"Restore a brand","deprecated":null,"version":null,"sidebarTitle":"Restore a brand","openapi":"/openapi.json post /projects/{projectId}/setup/brands/{brandId}/restore","href":"/api-reference/restore-a-brand"},{"title":"List tracked domains","deprecated":null,"version":null,"sidebarTitle":"List tracked domains","openapi":"/openapi.json get /projects/{projectId}/setup/domains","href":"/api-reference/list-tracked-domains"},{"title":"Add a domain","deprecated":null,"version":null,"sidebarTitle":"Add a domain","openapi":"/openapi.json post /projects/{projectId}/setup/domains","href":"/api-reference/add-a-domain"},{"title":"Update a domain","deprecated":null,"version":null,"sidebarTitle":"Update a domain","openapi":"/openapi.json patch /projects/{projectId}/setup/domains/{domainId}","href":"/api-reference/update-a-domain"},{"title":"Delete a domain","deprecated":null,"version":null,"sidebarTitle":"Delete a domain","openapi":"/openapi.json delete /projects/{projectId}/setup/domains/{domainId}","href":"/api-reference/delete-a-domain"},{"title":"List brand terms","deprecated":null,"version":null,"sidebarTitle":"List brand terms","openapi":"/openapi.json get /projects/{projectId}/setup/keywords","href":"/api-reference/list-brand-terms"},{"title":"Add a brand term","deprecated":null,"version":null,"sidebarTitle":"Add a brand term","openapi":"/openapi.json post /projects/{projectId}/setup/keywords","href":"/api-reference/add-a-brand-term"},{"title":"Update a brand term","deprecated":null,"version":null,"sidebarTitle":"Update a brand term","openapi":"/openapi.json patch /projects/{projectId}/setup/keywords/{keywordId}","href":"/api-reference/update-a-brand-term"},{"title":"Delete a brand term","deprecated":null,"version":null,"sidebarTitle":"Delete a brand term","openapi":"/openapi.json delete /projects/{projectId}/setup/keywords/{keywordId}","href":"/api-reference/delete-a-brand-term"},{"title":"List probed platforms","deprecated":null,"version":null,"sidebarTitle":"List probed platforms","openapi":"/openapi.json get /projects/{projectId}/setup/platforms","href":"/api-reference/list-probed-platforms"},{"title":"List content sources","deprecated":null,"version":null,"sidebarTitle":"List content sources","openapi":"/openapi.json get /projects/{projectId}/setup/content-sources","href":"/api-reference/list-content-sources"},{"title":"Add a content source","deprecated":null,"version":null,"sidebarTitle":"Add a content source","openapi":"/openapi.json post /projects/{projectId}/setup/content-sources","href":"/api-reference/add-a-content-source"},{"title":"List content repositories","deprecated":null,"version":null,"sidebarTitle":"List content repositories","openapi":"/openapi.json get /projects/{projectId}/setup/content-sources/repositories","href":"/api-reference/list-content-repositories"},{"title":"Switch automatic pull requests","deprecated":null,"version":null,"sidebarTitle":"Switch automatic pull requests","openapi":"/openapi.json patch /projects/{projectId}/setup/content-sources/{sourceId}","href":"/api-reference/switch-automatic-pull-requests"},{"title":"Remove a content source","description":"Removes a content source, as Remove does in Settings: drafts for pages under it stop opening pull requests or change requests, pull requests already open stay open, and its urlPrefix can be added again. Needs no content pull requests, and works on a paused project. A source already removed, or not in this project, is 404. Requires the `setup.write` scope.","deprecated":null,"version":null,"sidebarTitle":"Remove a content source","openapi":"/openapi.json delete /projects/{projectId}/setup/content-sources/{sourceId}","href":"/api-reference/remove-a-content-source"},{"title":"Draft a new project for a person to claim","deprecated":null,"version":null,"sidebarTitle":"Draft a new project for a person to claim","openapi":"/openapi.json post /projects/{projectId}/setup/new-project-draft","href":"/api-reference/draft-a-new-project-for-a-person-to-claim"},{"title":"Pause or resume a project","description":"Pauses or resumes the project. A paused project keeps its history readable but runs nothing new, frees its paid project slot, and refuses other setup changes until it is resumed, except disconnecting GA4 and changing content sources. Pausing needs the Agency plan (403 with reason agency_only). Resuming needs a free project slot (409 with reason no_free_slot) and room in the prompt allowance (409 with reason prompt_allowance). Requires the `setup.write` scope.","deprecated":null,"version":null,"sidebarTitle":"Pause or resume a project","openapi":"/openapi.json patch /projects/{projectId}/setup/project","href":"/api-reference/pause-or-resume-a-project"},{"title":"Get the Agent Picks catalogue","deprecated":null,"version":null,"sidebarTitle":"Get the agent picks catalogue","openapi":"/openapi.json get /projects/{projectId}/setup/catalogue/agent-picks","href":"/api-reference/get-the-agent-picks-catalogue"},{"title":"Get the AI platform catalogue","deprecated":null,"version":null,"sidebarTitle":"Get the ai platform catalogue","openapi":"/openapi.json get /projects/{projectId}/setup/catalogue/platforms","href":"/api-reference/get-the-ai-platform-catalogue"}]},{"group":"Prompts and topics","pages":[{"title":"List topics","deprecated":null,"version":null,"sidebarTitle":"List topics","openapi":"/openapi.json get /projects/{projectId}/visibility/topics","href":"/api-reference/list-topics"},{"title":"Create a topic","deprecated":null,"version":null,"sidebarTitle":"Create a topic","openapi":"/openapi.json post /projects/{projectId}/visibility/topics","href":"/api-reference/create-a-topic"},{"title":"Update a topic","deprecated":null,"version":null,"sidebarTitle":"Update a topic","openapi":"/openapi.json patch /projects/{projectId}/visibility/topics/{topicId}","href":"/api-reference/update-a-topic"},{"title":"Delete a topic","deprecated":null,"version":null,"sidebarTitle":"Delete a topic","openapi":"/openapi.json delete /projects/{projectId}/visibility/topics/{topicId}","href":"/api-reference/delete-a-topic"},{"title":"List tracked prompts","deprecated":null,"version":null,"sidebarTitle":"List tracked prompts","openapi":"/openapi.json get /projects/{projectId}/visibility/prompts","href":"/api-reference/list-tracked-prompts"},{"title":"Create a tracked prompt","deprecated":null,"version":null,"sidebarTitle":"Create a tracked prompt","openapi":"/openapi.json post /projects/{projectId}/visibility/prompts","href":"/api-reference/create-a-tracked-prompt"},{"title":"Update a tracked prompt","deprecated":null,"version":null,"sidebarTitle":"Update a tracked prompt","openapi":"/openapi.json patch /projects/{projectId}/visibility/prompts/{promptId}","href":"/api-reference/update-a-tracked-prompt"},{"title":"Delete a tracked prompt","deprecated":null,"version":null,"sidebarTitle":"Delete a tracked prompt","openapi":"/openapi.json delete /projects/{projectId}/visibility/prompts/{promptId}","href":"/api-reference/delete-a-tracked-prompt"},{"title":"Restore a deleted prompt","deprecated":null,"version":null,"sidebarTitle":"Restore a deleted prompt","openapi":"/openapi.json post /projects/{projectId}/visibility/prompts/{promptId}/restore","href":"/api-reference/restore-a-deleted-prompt"},{"title":"Get prompt-set analysis","deprecated":null,"version":null,"sidebarTitle":"Read prompt set analysis","openapi":"/openapi.json get /projects/{projectId}/prompt-set-analysis","href":"/api-reference/read-prompt-set-analysis"},{"title":"Start or retry prompt-set analysis","deprecated":null,"version":null,"sidebarTitle":"Start or retry prompt set analysis","openapi":"/openapi.json post /projects/{projectId}/prompt-set-analysis","href":"/api-reference/start-or-retry-prompt-set-analysis"},{"title":"Review a prompt-set proposal","deprecated":null,"version":null,"sidebarTitle":"Review a prompt set proposal","openapi":"/openapi.json post /projects/{projectId}/prompt-set-analysis/proposals","href":"/api-reference/review-a-prompt-set-proposal"}]},{"group":"Visibility","pages":[{"title":"List AI response history","deprecated":null,"version":null,"sidebarTitle":"List ai execution history","openapi":"/openapi.json get /projects/{projectId}/visibility/response-history","href":"/api-reference/list-ai-execution-history"},{"title":"List recent AI responses","deprecated":null,"version":null,"sidebarTitle":"List recent ai responses","openapi":"/openapi.json get /projects/{projectId}/visibility/responses","href":"/api-reference/list-recent-ai-responses"},{"title":"Get a retained AI response","deprecated":null,"version":null,"sidebarTitle":"Get a retained ai response","openapi":"/openapi.json get /projects/{projectId}/visibility/responses/{executionId}","href":"/api-reference/get-a-retained-ai-response"},{"title":"Get visibility summary metrics","deprecated":null,"version":null,"sidebarTitle":"Get visibility summary metrics","openapi":"/openapi.json get /projects/{projectId}/visibility/summary","href":"/api-reference/get-visibility-summary-metrics"},{"title":"Get brand sentiment","deprecated":null,"version":null,"sidebarTitle":"Get brand sentiment","openapi":"/openapi.json get /projects/{projectId}/visibility/sentiment","href":"/api-reference/get-brand-sentiment"},{"title":"Get probe health per AI platform","deprecated":null,"version":null,"sidebarTitle":"Get probe health per ai platform","openapi":"/openapi.json get /projects/{projectId}/visibility/probe-health","href":"/api-reference/get-probe-health-per-ai-platform"},{"title":"Get visibility diff","deprecated":null,"version":null,"sidebarTitle":"Get visibility diff","openapi":"/openapi.json get /projects/{projectId}/visibility/diff","href":"/api-reference/get-visibility-diff"},{"title":"Get project timeline events","deprecated":null,"version":null,"sidebarTitle":"Get project timeline events","openapi":"/openapi.json get /projects/{projectId}/timeline/events","href":"/api-reference/get-project-timeline-events"},{"title":"Get competitive positioning data","deprecated":null,"version":null,"sidebarTitle":"Get competitive positioning data","openapi":"/openapi.json get /projects/{projectId}/competitive/position","href":"/api-reference/get-competitive-positioning-data"}]},{"group":"Citations","pages":[{"title":"Get aggregate citation statistics","deprecated":null,"version":null,"sidebarTitle":"Get aggregate citation statistics","openapi":"/openapi.json get /projects/{projectId}/citations/stats","href":"/api-reference/get-aggregate-citation-statistics"},{"title":"Get top citation domains","deprecated":null,"version":null,"sidebarTitle":"Get top citation domains","openapi":"/openapi.json get /projects/{projectId}/citations/top-domains","href":"/api-reference/get-top-citation-domains"},{"title":"Get top citation pages","deprecated":null,"version":null,"sidebarTitle":"Get top citation pages","openapi":"/openapi.json get /projects/{projectId}/citations/top-pages","href":"/api-reference/get-top-citation-pages"},{"title":"List Lookalike sites","deprecated":null,"version":null,"sidebarTitle":"List lookalike sites","openapi":"/openapi.json get /projects/{projectId}/lookalike-sites","href":"/api-reference/list-lookalike-sites"},{"title":"List Lookalike site citations","deprecated":null,"version":null,"sidebarTitle":"List lookalike site citations","openapi":"/openapi.json get /projects/{projectId}/lookalike-sites/{hostId}/citations","href":"/api-reference/list-lookalike-site-citations"}]},{"group":"Positioning","pages":[{"title":"Get positioning match","deprecated":null,"version":null,"sidebarTitle":"Get positioning match","openapi":"/openapi.json get /projects/{projectId}/positioning","href":"/api-reference/get-positioning-match"},{"title":"List positioning statements","deprecated":null,"version":null,"sidebarTitle":"List positioning statements","openapi":"/openapi.json get /projects/{projectId}/positioning/statements","href":"/api-reference/list-positioning-statements"},{"title":"List positioning match answers","deprecated":null,"version":null,"sidebarTitle":"List positioning match answers","openapi":"/openapi.json get /projects/{projectId}/positioning/statements/{statementId}/answers","href":"/api-reference/list-positioning-match-answers"}]},{"group":"Accuracy","pages":[{"title":"Get Accuracy","deprecated":null,"version":null,"sidebarTitle":"Get accuracy","openapi":"/openapi.json get /projects/{projectId}/accuracy","href":"/api-reference/get-accuracy"},{"title":"List Accuracy claims","deprecated":null,"version":null,"sidebarTitle":"List accuracy claims","openapi":"/openapi.json get /projects/{projectId}/accuracy/claims","href":"/api-reference/list-accuracy-claims"},{"title":"Get Accuracy claim","deprecated":null,"version":null,"sidebarTitle":"Get accuracy claim","openapi":"/openapi.json get /projects/{projectId}/accuracy/claims/{groupId}","href":"/api-reference/get-accuracy-claim"},{"title":"List Accuracy contradictions","deprecated":null,"version":null,"sidebarTitle":"List accuracy contradictions","openapi":"/openapi.json get /projects/{projectId}/accuracy/contradictions","href":"/api-reference/list-accuracy-contradictions"},{"title":"Get Accuracy contradiction","deprecated":null,"version":null,"sidebarTitle":"Get accuracy contradiction","openapi":"/openapi.json get /projects/{projectId}/accuracy/contradictions/{sentenceKey}","href":"/api-reference/get-accuracy-contradiction"},{"title":"List Accuracy decisions","deprecated":null,"version":null,"sidebarTitle":"List accuracy decisions","openapi":"/openapi.json get /projects/{projectId}/accuracy/decisions","href":"/api-reference/list-accuracy-decisions"}]},{"group":"Content gaps","pages":[{"title":"List content gaps","deprecated":null,"version":null,"sidebarTitle":"List content gaps","openapi":"/openapi.json get /projects/{projectId}/content-gaps/list","href":"/api-reference/list-content-gaps"},{"title":"Get content gap evidence","deprecated":null,"version":null,"sidebarTitle":"Get content gap evidence","openapi":"/openapi.json get /projects/{projectId}/content-gaps/evidence","href":"/api-reference/get-content-gap-evidence"}]},{"group":"AI Traffic","pages":[{"title":"List recent answer fetches","deprecated":null,"version":null,"sidebarTitle":"List recent answer fetches","openapi":"/openapi.json get /projects/{projectId}/traffic/recent-answer-fetches","href":"/api-reference/list-recent-answer-fetches"},{"title":"Get visits per answer fetch","deprecated":null,"version":null,"sidebarTitle":"Get visits per answer fetch","openapi":"/openapi.json get /projects/{projectId}/traffic/visits-per-answer-fetch","href":"/api-reference/get-visits-per-answer-fetch"},{"title":"List AI referrals","deprecated":null,"version":null,"sidebarTitle":"List ai referrals","openapi":"/openapi.json get /projects/{projectId}/traffic/referrals","href":"/api-reference/list-ai-referrals"},{"title":"Get coding-agent answer fetches","deprecated":null,"version":null,"sidebarTitle":"Get coding agent answer fetches","openapi":"/openapi.json get /projects/{projectId}/traffic/coding-agents","href":"/api-reference/get-coding-agent-answer-fetches"},{"title":"Get AI Traffic sensors","deprecated":null,"version":null,"sidebarTitle":"Get ai traffic sensors","openapi":"/openapi.json get /projects/{projectId}/traffic/sensors","href":"/api-reference/get-ai-traffic-sensors"},{"title":"Disconnect GA4","deprecated":null,"version":null,"sidebarTitle":"Disconnect ga4","openapi":"/openapi.json delete /projects/{projectId}/traffic/sensors/ga4/{connectionId}","href":"/api-reference/disconnect-ga4"},{"title":"Rotate the edge ingest key","deprecated":null,"version":null,"sidebarTitle":"Rotate the edge ingest key","openapi":"/openapi.json post /projects/{projectId}/traffic/sensors/edge-middleware/ingest-key/rotate","href":"/api-reference/rotate-the-edge-ingest-key"},{"title":"Revoke the previous edge ingest key","deprecated":null,"version":null,"sidebarTitle":"Revoke the previous edge ingest key","openapi":"/openapi.json post /projects/{projectId}/traffic/sensors/edge-middleware/ingest-key/revoke-previous","href":"/api-reference/revoke-the-previous-edge-ingest-key"},{"title":"Save a Cloudflare source","deprecated":null,"version":null,"sidebarTitle":"Save a cloudflare source","openapi":"/openapi.json post /projects/{projectId}/traffic/sensors/cloudflare/sources","href":"/api-reference/save-a-cloudflare-source"},{"title":"Save a Cloudflare hostname","deprecated":null,"version":null,"sidebarTitle":"Save a cloudflare hostname","openapi":"/openapi.json post /projects/{projectId}/traffic/sensors/cloudflare/hostnames","href":"/api-reference/save-a-cloudflare-hostname"},{"title":"Pause or resume a Cloudflare hostname","deprecated":null,"version":null,"sidebarTitle":"Pause or resume a cloudflare hostname","openapi":"/openapi.json patch /projects/{projectId}/traffic/sensors/cloudflare/hostnames/{connectionId}","href":"/api-reference/pause-or-resume-a-cloudflare-hostname"},{"title":"Delete a Cloudflare hostname","deprecated":null,"version":null,"sidebarTitle":"Delete a cloudflare hostname","openapi":"/openapi.json delete /projects/{projectId}/traffic/sensors/cloudflare/hostnames/{connectionId}","href":"/api-reference/delete-a-cloudflare-hostname"},{"title":"Disconnect Search Console","deprecated":null,"version":null,"sidebarTitle":"Disconnect search console","openapi":"/openapi.json delete /projects/{projectId}/traffic/sensors/search-console/{connectionId}","href":"/api-reference/disconnect-search-console"},{"title":"List Vercel projects for the drain","deprecated":null,"version":null,"sidebarTitle":"List vercel projects for the drain","openapi":"/openapi.json get /projects/{projectId}/traffic/sensors/vercel-drain/projects","href":"/api-reference/list-vercel-projects-for-the-drain"},{"title":"Create the Vercel drain","deprecated":null,"version":null,"sidebarTitle":"Create the vercel drain","openapi":"/openapi.json post /projects/{projectId}/traffic/sensors/vercel-drain","href":"/api-reference/create-the-vercel-drain"},{"title":"Disconnect the Vercel drain","deprecated":null,"version":null,"sidebarTitle":"Disconnect the vercel drain","openapi":"/openapi.json delete /projects/{projectId}/traffic/sensors/vercel-drain","href":"/api-reference/disconnect-the-vercel-drain"},{"title":"List AI referral hosts","deprecated":null,"version":null,"sidebarTitle":"List ai referral hosts","openapi":"/openapi.json get /projects/{projectId}/traffic/referral-hosts","href":"/api-reference/list-ai-referral-hosts"},{"title":"Get 404 Demand","deprecated":null,"version":null,"sidebarTitle":"Get 404 demand","openapi":"/openapi.json get /projects/{projectId}/traffic/404-demand","href":"/api-reference/get-404-demand"},{"title":"Get AI-correlated Direct lift","deprecated":null,"version":null,"sidebarTitle":"Get ai correlated direct lift","openapi":"/openapi.json get /projects/{projectId}/traffic/direct-lift","href":"/api-reference/get-ai-correlated-direct-lift"},{"title":"Get traffic summary","deprecated":null,"version":null,"sidebarTitle":"Get traffic summary","openapi":"/openapi.json get /projects/{projectId}/traffic/summary","href":"/api-reference/get-traffic-summary"},{"title":"Get Search Console and analytics totals","deprecated":null,"version":null,"sidebarTitle":"Get search rollup totals","openapi":"/openapi.json get /projects/{projectId}/traffic/search-rollups","href":"/api-reference/get-search-rollup-totals"},{"title":"Get a page's Search Console queries","deprecated":null,"version":null,"sidebarTitle":"Get a pages search console queries","openapi":"/openapi.json get /projects/{projectId}/traffic/page-search-queries","href":"/api-reference/get-a-pages-search-console-queries"},{"title":"Get traffic by platform","deprecated":null,"version":null,"sidebarTitle":"Get traffic by platform","openapi":"/openapi.json get /projects/{projectId}/traffic/platforms","href":"/api-reference/get-traffic-by-platform"}]},{"group":"Adoption","pages":[{"title":"Get adoption metrics","deprecated":null,"version":null,"sidebarTitle":"Get adoption metrics","openapi":"/openapi.json get /projects/{projectId}/adoption/metrics","href":"/api-reference/get-adoption-metrics"}]},{"group":"Audit and pages","pages":[{"title":"Get Audit summary","deprecated":null,"version":null,"sidebarTitle":"Get audit summary","openapi":"/openapi.json get /projects/{projectId}/audit/summary","href":"/api-reference/get-audit-summary"},{"title":"Get the extracted section for an Audit finding","deprecated":null,"version":null,"sidebarTitle":"Get stored extraction for a section finding","openapi":"/openapi.json get /projects/{projectId}/audit/extraction","href":"/api-reference/get-stored-extraction-for-a-section-finding"},{"title":"Acknowledge or reconsider a retrieval restriction","deprecated":null,"version":null,"sidebarTitle":"Acknowledge or reconsider a retrieval restriction","openapi":"/openapi.json post /projects/{projectId}/audit/retrieval-intent","href":"/api-reference/acknowledge-or-reconsider-a-retrieval-restriction"},{"title":"List Audit findings","deprecated":null,"version":null,"sidebarTitle":"List audit findings","openapi":"/openapi.json get /projects/{projectId}/audit/findings","href":"/api-reference/list-audit-findings"},{"title":"Dismiss or restore an Audit finding","deprecated":null,"version":null,"sidebarTitle":"Dismiss or restore an audit finding","openapi":"/openapi.json post /projects/{projectId}/audit/findings/dismissal","href":"/api-reference/dismiss-or-restore-an-audit-finding"},{"title":"Create an action from an Audit finding","deprecated":null,"version":null,"sidebarTitle":"Create an action from an audit finding","openapi":"/openapi.json post /projects/{projectId}/audit/findings/action","href":"/api-reference/create-an-action-from-an-audit-finding"},{"title":"Get Google eligibility evidence","deprecated":null,"version":null,"sidebarTitle":"Get google eligibility evidence","openapi":"/openapi.json get /projects/{projectId}/audit/eligibility","href":"/api-reference/get-google-eligibility-evidence"},{"title":"List page metrics","deprecated":null,"version":null,"sidebarTitle":"List unified page metrics","openapi":"/openapi.json get /projects/{projectId}/pages/metrics","href":"/api-reference/list-unified-page-metrics"},{"title":"List page guard-rail findings","deprecated":null,"version":null,"sidebarTitle":"List page guard rail findings","openapi":"/openapi.json get /projects/{projectId}/pages/guard-rails","href":"/api-reference/list-page-guard-rail-findings"},{"title":"Lock a page","deprecated":null,"version":null,"sidebarTitle":"Lock a page","openapi":"/openapi.json post /projects/{projectId}/pages/guard-rails","href":"/api-reference/lock-a-page"},{"title":"Unlock a page","deprecated":null,"version":null,"sidebarTitle":"Unlock a page","openapi":"/openapi.json delete /projects/{projectId}/pages/guard-rails","href":"/api-reference/unlock-a-page"}]},{"group":"Actions","pages":[{"title":"List actions for a prompt","deprecated":null,"version":null,"sidebarTitle":"List actions for a prompt","openapi":"/openapi.json get /projects/{projectId}/actions/from-prompt","href":"/api-reference/list-actions-for-a-prompt"},{"title":"Create an action from a prompt","deprecated":null,"version":null,"sidebarTitle":"Create an action from a prompt","openapi":"/openapi.json post /projects/{projectId}/actions/from-prompt","href":"/api-reference/create-an-action-from-a-prompt"},{"title":"List actions","deprecated":null,"version":null,"sidebarTitle":"List actions","openapi":"/openapi.json get /projects/{projectId}/actions/list","href":"/api-reference/list-actions"},{"title":"Update an action","deprecated":null,"version":null,"sidebarTitle":"Update an action","openapi":"/openapi.json patch /projects/{projectId}/actions/{actionId}","href":"/api-reference/update-an-action"},{"title":"Change an action status","deprecated":null,"version":null,"sidebarTitle":"Change an action status","openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/status","href":"/api-reference/change-an-action-status"},{"title":"Get an action spot check","deprecated":null,"version":null,"sidebarTitle":"Get an action spot check","openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/spot-check","href":"/api-reference/get-an-action-spot-check"},{"title":"Start an action spot check","deprecated":null,"version":null,"sidebarTitle":"Start an action spot check","openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/spot-check","href":"/api-reference/start-an-action-spot-check"},{"title":"Split a merged suggestion","deprecated":null,"version":null,"sidebarTitle":"Split a merged suggestion","openapi":"/openapi.json post /projects/{projectId}/actions/split","href":"/api-reference/split-a-merged-suggestion"},{"title":"List action edits","deprecated":null,"version":null,"sidebarTitle":"List action edits","openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/events","href":"/api-reference/list-action-edits"},{"title":"Get action content draft","deprecated":null,"version":null,"sidebarTitle":"Get action content draft","openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/draft","href":"/api-reference/get-action-content-draft"},{"title":"Start an action content draft","deprecated":null,"version":null,"sidebarTitle":"Start an action content draft","openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/draft","href":"/api-reference/start-an-action-content-draft"},{"title":"Create action draft pull request","deprecated":null,"version":null,"sidebarTitle":"Create action draft pull request","openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/draft/pull-request","href":"/api-reference/create-action-draft-pull-request"},{"title":"Close action draft pull request","deprecated":null,"version":null,"sidebarTitle":"Close action draft pull request","openapi":"/openapi.json delete /projects/{projectId}/actions/{actionId}/draft/pull-request","href":"/api-reference/close-action-draft-pull-request"},{"title":"Get action brief","deprecated":null,"version":null,"sidebarTitle":"Get action brief","openapi":"/openapi.json get /projects/{projectId}/actions/{actionId}/brief","href":"/api-reference/get-action-brief"},{"title":"Generate action brief","deprecated":null,"version":null,"sidebarTitle":"Generate action brief","openapi":"/openapi.json post /projects/{projectId}/actions/{actionId}/brief","href":"/api-reference/generate-action-brief"}]},{"group":"Results","pages":[{"title":"List detected content changes","deprecated":null,"version":null,"sidebarTitle":"List detected content changes","openapi":"/openapi.json get /projects/{projectId}/outcomes/changes","href":"/api-reference/list-detected-content-changes"},{"title":"Get published-page tracking status","deprecated":null,"version":null,"sidebarTitle":"Read published page tracking status","openapi":"/openapi.json get /projects/{projectId}/outcomes/page-tracking","href":"/api-reference/read-published-page-tracking-status"},{"title":"Attach a published URL to a completed action","deprecated":null,"version":null,"sidebarTitle":"Attach a published url to a completed action","openapi":"/openapi.json post /projects/{projectId}/outcomes/changes/attach","href":"/api-reference/attach-a-published-url-to-a-completed-action"},{"title":"Claim a content change","deprecated":null,"version":null,"sidebarTitle":"Claim a content change","openapi":"/openapi.json post /projects/{projectId}/outcomes/changes/claim","href":"/api-reference/claim-a-content-change"},{"title":"Unclaim a content change","deprecated":null,"version":null,"sidebarTitle":"Unclaim a content change","openapi":"/openapi.json post /projects/{projectId}/outcomes/changes/unclaim","href":"/api-reference/unclaim-a-content-change"},{"title":"List measured results","deprecated":null,"version":null,"sidebarTitle":"List measured results","openapi":"/openapi.json get /projects/{projectId}/outcomes/ledger","href":"/api-reference/list-measured-results"},{"title":"Get the intelligence forecast","deprecated":null,"version":null,"sidebarTitle":"Get the intelligence forecast","openapi":"/openapi.json get /projects/{projectId}/intelligence/forecast","href":"/api-reference/get-the-intelligence-forecast"},{"title":"Get what-works recommendations","deprecated":null,"version":null,"sidebarTitle":"Get what works recommendations","openapi":"/openapi.json get /projects/{projectId}/intelligence/what-works","href":"/api-reference/get-what-works-recommendations"}]},{"group":"Agents","pages":[{"title":"List managed agents","deprecated":null,"version":null,"sidebarTitle":"List managed agents","openapi":"/openapi.json get /projects/{projectId}/agents","href":"/api-reference/list-managed-agents"},{"title":"Create a custom agent","deprecated":null,"version":null,"sidebarTitle":"Create a custom agent","openapi":"/openapi.json post /projects/{projectId}/agents","href":"/api-reference/create-a-custom-agent"},{"title":"List managed-agent runs","deprecated":null,"version":null,"sidebarTitle":"List managed agent runs","openapi":"/openapi.json get /projects/{projectId}/agents/runs","href":"/api-reference/list-managed-agent-runs"},{"title":"Get a managed-agent run","deprecated":null,"version":null,"sidebarTitle":"Get a managed agent run","openapi":"/openapi.json get /projects/{projectId}/agents/runs/{runId}","href":"/api-reference/get-a-managed-agent-run"},{"title":"Review a managed-agent draft","deprecated":null,"version":null,"sidebarTitle":"Review a managed agent draft","openapi":"/openapi.json post /projects/{projectId}/agents/runs/{runId}/review","href":"/api-reference/review-a-managed-agent-draft"},{"title":"Send a managed-agent run a follow-up","deprecated":null,"version":null,"sidebarTitle":"Send a managed agent run a follow up","openapi":"/openapi.json post /projects/{projectId}/agents/runs/{runId}/follow-ups","href":"/api-reference/send-a-managed-agent-run-a-follow-up"},{"title":"Update a custom agent","deprecated":null,"version":null,"sidebarTitle":"Update a custom agent","openapi":"/openapi.json patch /projects/{projectId}/agents/{agentKey}","href":"/api-reference/update-a-custom-agent"},{"title":"Archive a custom agent","deprecated":null,"version":null,"sidebarTitle":"Archive a custom agent","openapi":"/openapi.json delete /projects/{projectId}/agents/{agentKey}","href":"/api-reference/archive-a-custom-agent"},{"title":"Restore an archived custom agent","deprecated":null,"version":null,"sidebarTitle":"Restore an archived custom agent","openapi":"/openapi.json post /projects/{projectId}/agents/{agentKey}/restore","href":"/api-reference/restore-an-archived-custom-agent"},{"title":"Set an agent schedule","deprecated":null,"version":null,"sidebarTitle":"Set an agent schedule","openapi":"/openapi.json put /projects/{projectId}/agents/{agentKey}/schedule","href":"/api-reference/set-an-agent-schedule"},{"title":"Turn off an agent schedule","deprecated":null,"version":null,"sidebarTitle":"Turn off an agent schedule","openapi":"/openapi.json delete /projects/{projectId}/agents/{agentKey}/schedule","href":"/api-reference/turn-off-an-agent-schedule"},{"title":"Trigger a managed-agent run","deprecated":null,"version":null,"sidebarTitle":"Trigger a managed agent run","openapi":"/openapi.json post /projects/{projectId}/agents/{agentKey}/runs","href":"/api-reference/trigger-a-managed-agent-run"}]},{"group":"Dex","pages":[{"title":"List Dex conversation threads","deprecated":null,"version":null,"sidebarTitle":"List dex conversation threads","openapi":"/openapi.json get /projects/{projectId}/agents/dex/threads","href":"/api-reference/list-dex-conversation-threads"},{"title":"Start a Dex conversation","deprecated":null,"version":null,"sidebarTitle":"Start a dex conversation","openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads","href":"/api-reference/start-a-dex-conversation"},{"title":"Rename a Dex conversation thread","deprecated":null,"version":null,"sidebarTitle":"Rename a dex conversation thread","openapi":"/openapi.json patch /projects/{projectId}/agents/dex/threads/{threadId}","href":"/api-reference/rename-a-dex-conversation-thread"},{"title":"Delete your private Dex chat","deprecated":null,"version":null,"sidebarTitle":"Delete your private dex chat","openapi":"/openapi.json delete /projects/{projectId}/agents/dex/threads/{threadId}","href":"/api-reference/delete-your-private-dex-chat"},{"title":"List Dex conversation events","deprecated":null,"version":null,"sidebarTitle":"Read dex conversation events","openapi":"/openapi.json get /projects/{projectId}/agents/dex/threads/{threadId}/messages","href":"/api-reference/read-dex-conversation-events"},{"title":"Send a Dex conversation message","deprecated":null,"version":null,"sidebarTitle":"Send a dex conversation message","openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads/{threadId}/messages","href":"/api-reference/send-a-dex-conversation-message"},{"title":"List pending Dex specialist handoffs","deprecated":null,"version":null,"sidebarTitle":"List pending dex specialist handoffs","openapi":"/openapi.json get /projects/{projectId}/agents/dex/threads/{threadId}/handoffs","href":"/api-reference/list-pending-dex-specialist-handoffs"},{"title":"Confirm or cancel a Dex specialist handoff","deprecated":null,"version":null,"sidebarTitle":"Confirm or cancel a dex specialist handoff","openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads/{threadId}/handoffs","href":"/api-reference/confirm-or-cancel-a-dex-specialist-handoff"},{"title":"Save or dismiss a Dex memory offer","deprecated":null,"version":null,"sidebarTitle":"Save or dismiss a dex memory offer","openapi":"/openapi.json post /projects/{projectId}/agents/dex/threads/{threadId}/memory","href":"/api-reference/save-or-dismiss-a-dex-memory-offer"}]},{"group":"Agent Picks","pages":[{"title":"Update Agent Picks model settings","deprecated":null,"version":null,"sidebarTitle":"Update agent picks model settings","openapi":"/openapi.json patch /projects/{projectId}/agent-picks/settings","href":"/api-reference/update-agent-picks-model-settings"},{"title":"Get Agent Picks summary","deprecated":null,"version":null,"sidebarTitle":"Get agent picks summary","openapi":"/openapi.json get /projects/{projectId}/agent-picks/summary","href":"/api-reference/get-agent-picks-summary"},{"title":"List Agent Picks runs","deprecated":null,"version":null,"sidebarTitle":"List agent picks runs","openapi":"/openapi.json get /projects/{projectId}/agent-picks/runs","href":"/api-reference/list-agent-picks-runs"},{"title":"Get Agent Picks run evidence","deprecated":null,"version":null,"sidebarTitle":"Get agent picks run evidence","openapi":"/openapi.json get /projects/{projectId}/agent-picks/tests/{testId}/runs/{runId}","href":"/api-reference/get-agent-picks-run-evidence"},{"title":"Get Agent Picks run trace","deprecated":null,"version":null,"sidebarTitle":"Get agent picks run trace","openapi":"/openapi.json get /projects/{projectId}/agent-picks/runs/{runId}/trace","href":"/api-reference/get-agent-picks-run-trace"},{"title":"Quote an Agent Picks test","deprecated":null,"version":null,"sidebarTitle":"Quote an agent picks test","openapi":"/openapi.json post /projects/{projectId}/agent-picks/tests/quote","href":"/api-reference/quote-an-agent-picks-test"},{"title":"Start an Agent Picks test","deprecated":null,"version":null,"sidebarTitle":"Start an agent picks test","openapi":"/openapi.json post /projects/{projectId}/agent-picks/tests","href":"/api-reference/start-an-agent-picks-test"},{"title":"Cancel an Agent Picks test","deprecated":null,"version":null,"sidebarTitle":"Cancel an agent picks test","openapi":"/openapi.json delete /projects/{projectId}/agent-picks/tests/{testId}","href":"/api-reference/cancel-an-agent-picks-test"},{"title":"Create an Agent Picks self-run upload","deprecated":null,"version":null,"sidebarTitle":"Create an agent picks self run upload","openapi":"/openapi.json post /projects/{projectId}/agent-picks/uploads","href":"/api-reference/create-an-agent-picks-self-run-upload"},{"title":"Get an Agent Picks self-run upload","deprecated":null,"version":null,"sidebarTitle":"Get an agent picks self run upload","openapi":"/openapi.json get /projects/{projectId}/agent-picks/uploads/{runId}","href":"/api-reference/get-an-agent-picks-self-run-upload"},{"title":"Delete an Agent Picks self-run upload","deprecated":null,"version":null,"sidebarTitle":"Delete an agent picks self run upload","openapi":"/openapi.json delete /projects/{projectId}/agent-picks/uploads/{runId}","href":"/api-reference/delete-an-agent-picks-self-run-upload"},{"title":"Delete an Agent Picks self-run series","deprecated":null,"version":null,"sidebarTitle":"Delete an agent picks self run series","openapi":"/openapi.json delete /projects/{projectId}/agent-picks/series/{seriesKey}","href":"/api-reference/delete-an-agent-picks-self-run-series"},{"title":"Complete an Agent Picks self-run upload","deprecated":null,"version":null,"sidebarTitle":"Complete an agent picks self run upload","openapi":"/openapi.json post /projects/{projectId}/agent-picks/uploads/{runId}/complete","href":"/api-reference/complete-an-agent-picks-self-run-upload"},{"title":"Get Agent Picks schedule","deprecated":null,"version":null,"sidebarTitle":"Get agent picks schedule","openapi":"/openapi.json get /projects/{projectId}/agent-picks/schedule","href":"/api-reference/get-agent-picks-schedule"},{"title":"Enable Agent Picks schedule","deprecated":null,"version":null,"sidebarTitle":"Enable agent picks schedule","openapi":"/openapi.json put /projects/{projectId}/agent-picks/schedule","href":"/api-reference/enable-agent-picks-schedule"},{"title":"Turn off Agent Picks schedule","deprecated":null,"version":null,"sidebarTitle":"Turn off agent picks schedule","openapi":"/openapi.json delete /projects/{projectId}/agent-picks/schedule","href":"/api-reference/turn-off-agent-picks-schedule"},{"title":"Get Agent Picks test cells","deprecated":null,"version":null,"sidebarTitle":"Get agent picks test cells","openapi":"/openapi.json get /projects/{projectId}/agent-picks/cells","href":"/api-reference/get-agent-picks-test-cells"},{"title":"Get Agent Picks test history","deprecated":null,"version":null,"sidebarTitle":"Get agent picks test history","openapi":"/openapi.json get /projects/{projectId}/agent-picks/history","href":"/api-reference/get-agent-picks-test-history"},{"title":"Get Agent Picks Actions and re-test results","deprecated":null,"version":null,"sidebarTitle":"Get agent picks actions and re test results","openapi":"/openapi.json get /projects/{projectId}/agent-picks/actions","href":"/api-reference/get-agent-picks-actions-and-re-test-results"},{"title":"Get paid Agent Picks test","deprecated":null,"version":null,"sidebarTitle":"Get paid agent picks test","openapi":"/openapi.json get /projects/{projectId}/agent-picks/test","href":"/api-reference/get-paid-agent-picks-test"},{"title":"Get Agent Picks starter test","deprecated":null,"version":null,"sidebarTitle":"Get agent picks starter test","openapi":"/openapi.json get /projects/{projectId}/agent-picks/starter-test","href":"/api-reference/get-agent-picks-starter-test"},{"title":"Start Agent Picks starter test","deprecated":null,"version":null,"sidebarTitle":"Start agent picks starter test","openapi":"/openapi.json post /projects/{projectId}/agent-picks/starter-test","href":"/api-reference/start-agent-picks-starter-test"},{"title":"List Agent Picks setups","deprecated":null,"version":null,"sidebarTitle":"List agent picks setups","openapi":"/openapi.json get /projects/{projectId}/agent-picks/setup","href":"/api-reference/list-agent-picks-setups"},{"title":"Save Agent Picks setup","deprecated":null,"version":null,"sidebarTitle":"Save agent picks setup","openapi":"/openapi.json put /projects/{projectId}/agent-picks/setup","href":"/api-reference/save-agent-picks-setup"},{"title":"Clear Agent Picks setup","deprecated":null,"version":null,"sidebarTitle":"Clear agent picks setup","openapi":"/openapi.json delete /projects/{projectId}/agent-picks/setup","href":"/api-reference/clear-agent-picks-setup"},{"title":"Draft Agent Picks job","deprecated":null,"version":null,"sidebarTitle":"Draft agent picks job","openapi":"/openapi.json post /projects/{projectId}/agent-picks/job/draft","href":"/api-reference/draft-agent-picks-job"},{"title":"Draft Agent Picks tool signals","deprecated":null,"version":null,"sidebarTitle":"Draft agent picks tool signals","openapi":"/openapi.json post /projects/{projectId}/agent-picks/tools/draft","href":"/api-reference/draft-agent-picks-tool-signals"},{"title":"Save Agent Picks job","deprecated":null,"version":null,"sidebarTitle":"Save agent picks job","openapi":"/openapi.json put /projects/{projectId}/agent-picks/job","href":"/api-reference/save-agent-picks-job"}]},{"group":"Library and Knowledge","pages":[{"title":"List Library items","deprecated":null,"version":null,"sidebarTitle":"List library items","openapi":"/openapi.json get /projects/{projectId}/library","href":"/api-reference/list-library-items"},{"title":"Upload a text document to the Library","deprecated":null,"version":null,"sidebarTitle":"Upload a text document to the library","openapi":"/openapi.json post /projects/{projectId}/library","href":"/api-reference/upload-a-text-document-to-the-library"},{"title":"Search Library items","deprecated":null,"version":null,"sidebarTitle":"Hybrid search library items","openapi":"/openapi.json get /projects/{projectId}/library/search","href":"/api-reference/hybrid-search-library-items"},{"title":"Get a Library item","deprecated":null,"version":null,"sidebarTitle":"Read a library item","openapi":"/openapi.json get /projects/{projectId}/library/{itemId}","href":"/api-reference/read-a-library-item"},{"title":"Update Library grounding availability or version link","deprecated":null,"version":null,"sidebarTitle":"Update library grounding availability or version link","openapi":"/openapi.json patch /projects/{projectId}/library/{itemId}","href":"/api-reference/update-library-grounding-availability-or-version-link"},{"title":"Get the Knowledge Profile and proposals","deprecated":null,"version":null,"sidebarTitle":"Read the knowledge profile and proposal queue","openapi":"/openapi.json get /projects/{projectId}/knowledge","href":"/api-reference/read-the-knowledge-profile-and-proposal-queue"},{"title":"Update one Knowledge Profile field","deprecated":null,"version":null,"sidebarTitle":"Update one knowledge profile field","openapi":"/openapi.json patch /projects/{projectId}/knowledge","href":"/api-reference/update-one-knowledge-profile-field"},{"title":"Review a Knowledge Profile proposal","deprecated":null,"version":null,"sidebarTitle":"Review a knowledge profile proposal","openapi":"/openapi.json post /projects/{projectId}/knowledge/proposals/{proposalId}","href":"/api-reference/review-a-knowledge-profile-proposal"}]},{"group":"Webhooks","pages":[{"title":"List webhook subscriptions","deprecated":null,"version":null,"sidebarTitle":"List webhook subscriptions","openapi":"/openapi.json get /projects/{projectId}/webhooks","href":"/api-reference/list-webhook-subscriptions"},{"title":"Create a webhook subscription","deprecated":null,"version":null,"sidebarTitle":"Create webhook subscription","openapi":"/openapi.json post /projects/{projectId}/webhooks","href":"/api-reference/create-webhook-subscription"},{"title":"Deactivate a webhook subscription","deprecated":null,"version":null,"sidebarTitle":"Delete webhook subscription","openapi":"/openapi.json delete /projects/{projectId}/webhooks/{webhookId}","href":"/api-reference/delete-webhook-subscription"},{"title":"Rotate a webhook signing secret","deprecated":null,"version":null,"sidebarTitle":"Rotate webhook signing secret","openapi":"/openapi.json post /projects/{projectId}/webhooks/{webhookId}/rotate-secret","href":"/api-reference/rotate-webhook-signing-secret"}]},{"group":"Agent registration","pages":[{"title":"Get the agent setup draft","deprecated":null,"version":null,"sidebarTitle":"Get the agent setup draft","openapi":"/openapi.json get /agent/setup-draft","href":"/api-reference/get-the-agent-setup-draft"},{"title":"Replace the agent setup draft","deprecated":null,"version":null,"sidebarTitle":"Replace the agent setup draft","openapi":"/openapi.json put /agent/setup-draft","href":"/api-reference/replace-the-agent-setup-draft"},{"title":"Get the Agent Picks catalogue for a draft","deprecated":null,"version":null,"sidebarTitle":"Get the agent picks catalogue for a draft","openapi":"/openapi.json get /agent/catalogue/agent-picks","href":"/api-reference/get-the-agent-picks-catalogue-for-a-draft"},{"title":"Get the AI platform catalogue for a draft","deprecated":null,"version":null,"sidebarTitle":"Get the ai platform catalogue for a draft","openapi":"/openapi.json get /agent/catalogue/platforms","href":"/api-reference/get-the-ai-platform-catalogue-for-a-draft"}]}]}]}]},"basePath":"","title":"Draft a new project for a person to claim - DevTune","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-_HcdDqS2.js","snippetPresets-CXnm-WO6.js","utils-Dg59J__o.js","style-to-object-BY3JEAdk.js","utils-D8TRpdk7.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-B6QaxWc5.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DeMZ-lcM.js","_Uint8Array-BjA2mcVW.js","isObject-FP1Yky1u.js","ApiExamples-cjPyMv63.js","usePlaygroundInputsStore-D7BWoaw4.js","shallow-Z1ceDNSG.js","isEqual-BObTuQrO.js","CodeSnippets-D1UZ1AE-.js","CodeSnippet-B373COAT.js","getApiPlaygroundDisplay-CfL-UuDS.js","Page-DuqezyvM.js","DynamicMarkdown-5yMTCLas.js","SectionHeading-BxT1HYfP.js","icon-DYJTTD3g.js","MethodPill-4AyycJeu.js","getPastedJson-Bp3WV6cN.js","Check2Icon-PhZu6Gry.js","axios-CsQoIw0U.js","Markdown-Dy9a8hT8.js","AssistantPageLink-87tSPwGm.js","dist-CXMB3QQU.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}