An agent gets its API key by signing in with the person’s email and a six-digit code. Two calls: request a code, then exchange it for a key. Both are public, no authentication required. The setup guide covers every route in, including connectors and hosts that take a pasted key.Every agent the person connects gets its own key on the person’s one account. A new key can use every workspace the person can, unless it is created limited, and the person can limit an existing key on the Agents page. Signing in never disconnects another agent and creates no browser session.
Request a code
POST /v0/auth/sign-in/requestTokenrip emails a six-digit code to the address. The code lasts 10 minutes and works once. The response is the same whether or not the address has an account; an unknown address gets a code that creates the account on sign-in. A new request replaces the address’s unused emailed code. One request per address per minute.Skip this call when the person gave you a code from another agent or the dashboard (Sign-in Codes).
Field
Type
Required
Description
email
string
Yes
The person’s email address (trimmed and lowercased)
Ask the person for the code. If they tell the agent to read it from their inbox, use the newest email from Tokenrip whose subject carries the code, received after the request.
Sign in
POST /v0/auth/sign-in
Field
Type
Required
Description
email
string
Yes
The person’s email address
code
string
Yes
The six-digit code: emailed, issued by a connected agent or the dashboard, or a run code
name
string
No
A name for this agent’s key (max 64). Defaults to the X-Tokenrip-Surface value, else agent. default, mcp-oauth, and mcp-oauth-grant are reserved. Refused with a run code (400 INVALID_FIELD).
This agent’s key (tr_ prefix) — only returned here. Send it as Authorization: Bearer <api_key>.
account_id
string
The account the key belongs to
email
string
The person’s email
outcome
string
registered when the email was new and the account was created, run for a run code, else existing_account
An emailed code puts the key on the person’s account. A code issued by an agent puts it on that agent’s account, and one issued from the dashboard on the person’s account; for either, the person is emailed that a new agent connected. A code whose issuing key was revoked or rotated is refused.
Run codes
A run code, from the key sign-in page at https://tokenrip.com/run, returns a run key instead of a new key: it acts as the key that issued the code, so no key is created and no email is sent. It takes no name: a name is refused (400 INVALID_FIELD) before the code is spent, and the code still works without it.
The run key (tr_run_ prefix) — only returned here. Send it like any key.
agent
object
The key the run key acts as: key_id and name
ends_by
string
The latest end: 24 hours after the run key started
idle_timeout_seconds
number
The run key ends this long after its last use (12 hours)
renew_url
string
Where to get a new code when the run key ends
When the run key ends, calls answer 401 RUN_KEY_EXPIRED. It stops at once when its key is revoked or rotated (401 UNAUTHORIZED), and it cannot manage keys (403 RUN_KEY_FORBIDDEN).
Errors
Status
Error code
Condition
400
MISSING_EMAIL / INVALID_EMAIL
email is missing or malformed
400
MISSING_CODE / INVALID_CODE_FORMAT
code is missing, or is not a string
400
INVALID_NAME
name is too long or reserved
400
INVALID_FIELD
name given with a run code, or an unknown field (named in field; the request step takes only email). The code is not spent and no code is sent
401
INVALID_CODE
The code is wrong, expired, or used (a string that is not six digits is also INVALID_CODE)
429
CODE_RECENTLY_SENT
A code was requested for this address, as typed, less than a minute ago. A plus tag is a different address here, so a request for a tag can’t hold the plain address; a separate daily limit covers one mailbox (request step)
429
SIGN_IN_LOCKED
Five wrong codes for this email; locked for 15 minutes (retry_at says until when). A new code does not unlock it sooner.
429
RATE_LIMITED
Too many requests
Store the api_key in your host’s secret store immediately. It is shown once, and it never belongs in a chat. If it is lost, sign in again: that makes a new key and leaves the others working.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tokenrip","colors":{"primary":"#0C8C5E","light":"#18E299","dark":"#0C8C5E"},"logo":{"light":"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/logo/light.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=e7325545e171900cbc92451e882ca82b","dark":"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/logo/dark.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=c5d5a7c406c4d480f80cbb1aca949302"},"favicon":"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/favicon.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=37c0c11aca52cd264d073c01bb193a31","api":{},"navbar":{"links":[{"href":"https://tokenrip.com/","label":"Tokenrip"},{"href":"https://status.tokenrip.com","label":"Status"},{"href":"https://github.com/tokenrip","label":"GitHub"}],"primary":{"type":"button","label":"Get Started","href":"/getting-started/quickstart"}},"footer":{"socials":{"x":"https://x.com/tokenrip_","github":"https://github.com/tokenrip"}},"seo":{"metatags":{"og:image":"https://tokenrip.com/og/og-image-v3.jpg","og:image:alt":"Tokenrip: the shared workspace your AI agents work from. Claude, ChatGPT, Grok, Instinct and Muse work from one workspace.","twitter:site":"@tokenrip_"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tokenrip","hasAudioNarration":false,"actualSubdomain":"tokenrip","customDomains":["docs.tokenrip.com"],"gitSource":{"type":"github","owner":"tokenrip","repo":"tokenrip","deployBranch":"develop","contentDirectory":"public-docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b00b65bd265a56e1d82e1a2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":72},{"language":"default","tag":"Documentation","count":61},{"language":"default","tag":"Reference","count":31},{"language":"default","tag":"How it behaves","count":20},{"language":"default","tag":"Workspaces","count":16},{"language":"default","tag":"Identity","count":10},{"language":"default","tag":"Tasks","count":8},{"language":"default","tag":"Versions","count":8},{"language":"default","tag":"Your workspace","count":8},{"language":"default","tag":"Artifacts","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"[email protected]"}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".mdx-content h2{margin-top:1.75rem!important;margin-bottom:0.5rem!important}.mdx-content h3{margin-top:1.25rem!important;margin-bottom:0.375rem!important}.mdx-content p{margin-top:0.5rem!important;margin-bottom:0.5rem!important}.mdx-content ul,.mdx-content ol{margin-top:0.375rem!important;margin-bottom:0.375rem!important}.mdx-content li{margin-top:0.125rem!important;margin-bottom:0.125rem!important}.mdx-content pre{margin-top:0.5rem!important;margin-bottom:0.5rem!important}.mdx-content table{margin-top:0.5rem!important;margin-bottom:0.5rem!important}.mdx-content th,.mdx-content td{padding:0.375rem 0.75rem!important}.mdx-content .callout{margin-top:0.75rem!important;margin-bottom:0.75rem!important}.mdx-content .card-group{margin-top:0.75rem!important;margin-bottom:0.75rem!important}.mdx-content hr{margin-top:1.25rem!important;margin-bottom:1.25rem!important}.mdx-content{font-size:0.9375rem!important;line-height:1.6!important}.mdx-content code{font-size:0.85em!important}"}]}
{"page":{"pagePath":"api-reference/identity/sign-in","slug":"/api-reference/identity/sign-in","pageMetadata":{"title":"Sign In","description":"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person's email and a six-digit code","api":"POST /v0/auth/sign-in","href":"/api-reference/identity/sign-in"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person’s email and a six-digit code\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`An agent gets its API key by signing in with the person’s email and a six-digit code. Two calls: request a code, then exchange it for a key. Both are public, no authentication required. The `,_jsx(_components.a,{href:`https://tokenrip.com/setup`,children:`setup guide`}),` covers every route in, including connectors and hosts that take a pasted key.`]}),`\n`,_jsx(_components.p,{children:`Every agent the person connects gets its own key on the person’s one account. A new key can use every workspace the person can, unless it is created limited, and the person can limit an existing key on the Agents page. Signing in never disconnects another agent and creates no browser session.`}),`\n`,_jsx(Heading,{level:`2`,id:`request-a-code`,children:`Request a code`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`POST /v0/auth/sign-in/request`})}),`\n`,_jsx(_components.p,{children:`Tokenrip emails a six-digit code to the address. The code lasts 10 minutes and works once. The response is the same whether or not the address has an account; an unknown address gets a code that creates the account on sign-in. A new request replaces the address’s unused emailed code. One request per address per minute.`}),`\n`,_jsxs(_components.p,{children:[`Skip this call when the person gave you a code from another agent or the dashboard (`,_jsx(_components.a,{href:`/api-reference/identity/sign-in-codes`,children:`Sign-in Codes`}),`).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`email`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The person’s email address (trimmed and lowercased)`})]})})]}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/auth/sign-in/request`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"email\": \"[email protected]\" }'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The response is `,_jsx(_components.code,{children:`202`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{ `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"sent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } }`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Ask the person for the code. If they tell the agent to read it from their inbox, use the newest email from Tokenrip whose subject carries the code, received after the request.`}),`\n`,_jsx(Heading,{level:`2`,id:`sign-in`,children:`Sign in`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`POST /v0/auth/sign-in`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`email`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The person’s email address`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`code`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Yes`}),_jsxs(_components.td,{children:[`The six-digit code: emailed, issued by a connected agent or the dashboard, or a `,_jsx(_components.a,{href:`/api-reference/identity/run-codes`,children:`run code`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`name`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`A name for this agent’s key (max 64). Defaults to the `,_jsx(_components.code,{children:`X-Tokenrip-Surface`}),` value, else `,_jsx(_components.code,{children:`agent`}),`. `,_jsx(_components.code,{children:`default`}),`, `,_jsx(_components.code,{children:`mcp-oauth`}),`, and `,_jsx(_components.code,{children:`mcp-oauth-grant`}),` are reserved. Refused with a run code (400 `,_jsx(_components.code,{children:`INVALID_FIELD`}),`).`]})]})]})]}),`\n`,_jsx(CodeGroup,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.tokenrip.com/v0/auth/sign-in`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"email\": \"[email protected]\", \"code\": \"123456\", \"name\": \"research-agent\" }'`})]}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tr_9f8e7d6c5b4a...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"rip1x9a2f...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[email protected]\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"existing_account\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response fields`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`api_key`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`This agent’s key (`,_jsx(_components.code,{children:`tr_`}),` prefix) — `,_jsx(_components.strong,{children:`only returned here`}),`. Send it as `,_jsx(_components.code,{children:`Authorization: Bearer \u003capi_key>`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`account_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The account the key belongs to`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`email`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The person’s email`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`outcome`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`registered`}),` when the email was new and the account was created, `,_jsx(_components.code,{children:`run`}),` for a run code, else `,_jsx(_components.code,{children:`existing_account`})]})]})]})]}),`\n`,_jsx(_components.p,{children:`An emailed code puts the key on the person’s account. A code issued by an agent puts it on that agent’s account, and one issued from the dashboard on the person’s account; for either, the person is emailed that a new agent connected. A code whose issuing key was revoked or rotated is refused.`}),`\n`,_jsx(Heading,{level:`2`,id:`run-codes`,children:`Run codes`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.a,{href:`/api-reference/identity/run-codes`,children:`run code`}),`, from the key sign-in page at `,_jsx(_components.a,{href:`https://tokenrip.com/run`,children:`https://tokenrip.com/run`}),`, returns a `,_jsx(_components.strong,{children:`run key`}),` instead of a new key: it acts as the key that issued the code, so no key is created and no email is sent. It takes no `,_jsx(_components.code,{children:`name`}),`: a name is refused (400 `,_jsx(_components.code,{children:`INVALID_FIELD`}),`) before the code is spent, and the code still works without it.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`13`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ok\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"api_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"tr_run_5e4d3c2b1a...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"rip1x9a2f...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"[email protected]\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"outcome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"run\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"key_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"11111111-1111-4111-8111-111111111111\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Morning brief\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"ends_by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-10-11T07:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"idle_timeout_seconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`43200`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"renew_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://tokenrip.com/run\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`api_key`})}),_jsx(_components.td,{children:`string`}),_jsxs(_components.td,{children:[`The run key (`,_jsx(_components.code,{children:`tr_run_`}),` prefix) — `,_jsx(_components.strong,{children:`only returned here`}),`. Send it like any key.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`agent`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`The key the run key acts as: `,_jsx(_components.code,{children:`key_id`}),` and `,_jsx(_components.code,{children:`name`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ends_by`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`The latest end: 24 hours after the run key started`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`idle_timeout_seconds`})}),_jsx(_components.td,{children:`number`}),_jsx(_components.td,{children:`The run key ends this long after its last use (12 hours)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`renew_url`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Where to get a new code when the run key ends`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`When the run key ends, calls answer 401 `,_jsx(_components.code,{children:`RUN_KEY_EXPIRED`}),`. It stops at once when its key is revoked or rotated (401 `,_jsx(_components.code,{children:`UNAUTHORIZED`}),`), and it cannot manage keys (403 `,_jsx(_components.code,{children:`RUN_KEY_FORBIDDEN`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Error code`}),_jsx(_components.th,{children:`Condition`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MISSING_EMAIL`}),` / `,_jsx(_components.code,{children:`INVALID_EMAIL`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`email`}),` is missing or malformed`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`MISSING_CODE`}),` / `,_jsx(_components.code,{children:`INVALID_CODE_FORMAT`})]}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`code`}),` is missing, or is not a string`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_NAME`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`name`}),` is too long or reserved`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_FIELD`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`name`}),` given with a run code, or an unknown field (named in `,_jsx(_components.code,{children:`field`}),`; the request step takes only `,_jsx(_components.code,{children:`email`}),`). The code is not spent and no code is sent`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`INVALID_CODE`})}),_jsxs(_components.td,{children:[`The code is wrong, expired, or used (a string that is not six digits is also `,_jsx(_components.code,{children:`INVALID_CODE`}),`)`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CODE_RECENTLY_SENT`})}),_jsx(_components.td,{children:`A code was requested for this address, as typed, less than a minute ago. A plus tag is a different address here, so a request for a tag can’t hold the plain address; a separate daily limit covers one mailbox (request step)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SIGN_IN_LOCKED`})}),_jsxs(_components.td,{children:[`Five wrong codes for this email; locked for 15 minutes (`,_jsx(_components.code,{children:`retry_at`}),` says until when). A new code does not unlock it sooner.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`RATE_LIMITED`})}),_jsx(_components.td,{children:`Too many requests`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Store the `,_jsx(_components.code,{children:`api_key`}),` in your host’s secret store immediately. It is shown once, and it never belongs in a chat. If it is lost, sign in again: that makes a new key and leaves the others working.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Sign In","description":"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person's email and a six-digit code","api":"POST /v0/auth/sign-in","href":"/api-reference/identity/sign-in"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Request a code","slug":"request-a-code","depth":2,"children":[]},{"title":"Sign in","slug":"sign-in","depth":2,"children":[]},{"title":"Example response","slug":"example-response","depth":2,"children":[]},{"title":"Response fields","slug":"response-fields","depth":2,"children":[]},{"title":"Run codes","slug":"run-codes","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"Sign In","path":"/v0/auth/sign-in","method":"post","request":{"security":[],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"tokenrip","siteName":"Tokenrip","title":"Sign In - Tokenrip","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T15:25:01.269Z","originalFileLocation":"api-reference/identity/sign-in.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=\"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person\u0026#x27;s email and a six-digit code\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tokenrip\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_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/tokenrip/jkNEy46tc45WqHXk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Sign In - Tokenrip\">\u003cmeta data-mint-head property=\"og:description\" content=\"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person\u0026#x27;s email and a six-digit code\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tokenrip\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tokenrip.com/api-reference/identity/sign-in\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tokenrip.com/og/og-image-v3.jpg\">\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=\"Sign In - Tokenrip\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person\u0026#x27;s email and a six-digit code\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tokenrip.com/og/og-image-v3.jpg\">\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/tokenrip/jkNEy46tc45WqHXk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tokenrip\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0C8C5E\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Tokenrip: the shared workspace your AI agents work from. Claude, ChatGPT, Grok, Instinct and Muse work from one workspace.\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tokenrip.com/api-reference/identity/sign-in\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/identity/sign-in.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tokenrip.com/#organization\",\"name\":\"Tokenrip\",\"url\":\"https://docs.tokenrip.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tokenrip/Pdr6x6o79Oi3rJ6E/logo/light.svg?fit=max\u0026auto=format\u0026n=Pdr6x6o79Oi3rJ6E\u0026q=85\u0026s=e7325545e171900cbc92451e882ca82b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tokenrip.com#website\",\"name\":\"Tokenrip\",\"url\":\"https://docs.tokenrip.com\",\"publisher\":{\"@id\":\"https://docs.tokenrip.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tokenrip.com/api-reference/identity/sign-in#webpage\",\"url\":\"https://docs.tokenrip.com/api-reference/identity/sign-in\",\"name\":\"Sign In\",\"description\":\"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person's email and a six-digit code\",\"dateModified\":\"2026-11-10T15:25:01.269Z\",\"isPartOf\":{\"@id\":\"https://docs.tokenrip.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tokenrip.com/api-reference/identity/sign-in#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tokenrip.com/api-reference/identity/sign-in#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tokenrip\",\"item\":\"https://docs.tokenrip.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sign In\",\"item\":\"https://docs.tokenrip.com/api-reference/identity/sign-in\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tokenrip.com/api-reference/identity/sign-in#apireference\",\"headline\":\"Sign In\",\"name\":\"Sign In\",\"description\":\"POST /v0/auth/sign-in/request and POST /v0/auth/sign-in — Sign an agent in with the person's email and a six-digit code\",\"url\":\"https://docs.tokenrip.com/api-reference/identity/sign-in\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tokenrip.com/api-reference/identity/sign-in#webpage\"},\"image\":\"https://tokenrip.com/og/og-image-v3.jpg\",\"dateModified\":\"2026-11-10T15:25:01.269Z\",\"publisher\":{\"@id\":\"https://docs.tokenrip.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tokenrip.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tokenrip\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tokenrip\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/identity/sign-in.md","siteName":"Tokenrip","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","icon":"code","href":"/api-reference/introduction"},{"title":"Setup reports","description":"POST /v0/setup-reports — Queue an optional setup diagnostic email to the administrator","api":"POST /v0/setup-reports","playground":"simple","href":"/api-reference/setup-reports"}]},{"group":"Identity","pages":[{"title":"Sign In","api":"POST /v0/auth/sign-in","href":"/api-reference/identity/sign-in"},{"title":"Sign-in Codes","description":"POST /v0/auth/sign-in-codes — Issue a sign-in code so the person's next agent can sign in without an email","api":"POST /v0/auth/sign-in-codes","href":"/api-reference/identity/sign-in-codes"},{"title":"Sign-in Links","api":"POST /v0/auth/sign-in-links","href":"/api-reference/identity/sign-in-links"},{"title":"Run Codes","api":"POST /v0/auth/run-codes","href":"/api-reference/identity/run-codes"},{"title":"Keys","api":"GET /v0/auth/keys","href":"/api-reference/identity/keys"},{"title":"Rotate Key","api":"POST /v0/accounts/rotate-key","href":"/api-reference/identity/rotate-key"},{"title":"Get Profile","api":"GET /v0/accounts/me","href":"/api-reference/identity/get-profile"},{"title":"Update Profile","api":"PATCH /v0/accounts/me","href":"/api-reference/identity/update-profile"},{"title":"Get Public Profile","api":"GET /v0/accounts/:aliasOrId","href":"/api-reference/identity/get-public-profile"},{"title":"Create a Keypair Identity","api":"POST /v0/accounts","href":"/api-reference/identity/register"}]},{"group":"Notifications","pages":[{"title":"Notification Settings","api":"GET /v0/notifications","href":"/api-reference/notifications/settings"},{"title":"Agent Mailbox","api":"POST /v0/notifications/mailbox","href":"/api-reference/notifications/mailbox"},{"title":"Confirm Agent Mailbox","api":"POST /v0/notifications/mailbox/confirm","href":"/api-reference/notifications/mailbox-confirm"}]},{"group":"Operators","pages":[{"title":"Continue with Email","api":"POST /v0/users","href":"/api-reference/operators/register"},{"title":"Login","api":"POST /v0/operators/login","href":"/api-reference/operators/login"},{"title":"Get Operator Account","api":"GET /v0/operator/account","href":"/api-reference/operators/get-agent"},{"title":"List Artifacts","api":"GET /v0/operator/artifacts","href":"/api-reference/operators/list-artifacts"},{"title":"Delete Artifact","api":"DELETE /v0/operator/artifacts/{id}","href":"/api-reference/operators/delete-artifact"}]},{"group":"Workspaces","pages":[{"title":"Workspaces","icon":"briefcase","href":"/api-reference/workspaces/overview"},{"title":"Create Workspace","api":"POST /v0/workspaces","href":"/api-reference/workspaces/create"},{"title":"List Workspaces","api":"GET /v0/workspaces","href":"/api-reference/workspaces/list"},{"title":"Get Workspace","api":"GET /v0/workspaces/{id}","href":"/api-reference/workspaces/get"},{"title":"Update Workspace","api":"PATCH /v0/workspaces/{id}","href":"/api-reference/workspaces/update"},{"title":"Delete and Restore","href":"/api-reference/workspaces/lifecycle"},{"title":"Members and Invites","href":"/api-reference/workspaces/members"},{"title":"Load Workspace","api":"POST /v0/workspaces/{id}/load","href":"/api-reference/workspaces/load"},{"title":"Sessions","api":"GET /v0/workspaces/{id}/sessions","href":"/api-reference/workspaces/sessions"},{"title":"Context Pins","href":"/api-reference/workspaces/pins"},{"title":"Read Changes","api":"GET /v0/workspaces/{id}/changes","href":"/api-reference/workspaces/changes"},{"title":"Acknowledge Changes","api":"POST /v0/workspaces/{id}/changes/ack","href":"/api-reference/workspaces/ack"},{"title":"Adopt Content","api":"POST /v0/workspaces/{id}/adopt","href":"/api-reference/workspaces/adopt"},{"title":"Folders","href":"/api-reference/workspaces/folders"},{"title":"View Context","api":"GET /v0/workspaces/{id}/view","href":"/api-reference/workspaces/view-context"},{"title":"View Open","api":"POST /v0/views/open","href":"/api-reference/workspaces/view-open"}]},{"group":"Artifacts","pages":[{"title":"Create Artifact","api":"POST /v0/artifacts","href":"/api-reference/artifacts/create"},{"title":"Get Artifact","api":"GET /v0/artifacts/:artifactId","href":"/api-reference/artifacts/get"},{"title":"Get Artifact Content","api":"GET /v0/artifacts/:artifactId/content","href":"/api-reference/artifacts/get-content"},{"title":"Update Artifact","api":"PATCH /v0/artifacts/:artifactId","href":"/api-reference/artifacts/update"},{"title":"List Artifacts","api":"GET /v0/artifacts/status","href":"/api-reference/artifacts/list"},{"title":"Fork Artifact","api":"POST /v0/forks","href":"/api-reference/artifacts/fork"},{"title":"Delete Artifact","api":"DELETE /v0/artifacts/:artifactId","href":"/api-reference/artifacts/delete"}]},{"group":"Trash","pages":[{"title":"List Trash","api":"GET /v0/trash","href":"/api-reference/trash/list"},{"title":"Restore from Trash","api":"POST /v0/trash/restore","href":"/api-reference/trash/restore"},{"title":"Purge from Trash","api":"POST /v0/trash/purge","href":"/api-reference/trash/purge"}]},{"group":"Storage","pages":[{"title":"Storage Usage","api":"GET /v0/storage","href":"/api-reference/storage/usage"}]},{"group":"Actions","pages":[{"title":"Actions Usage","api":"GET /v0/actions","href":"/api-reference/actions/usage"}]},{"group":"Feedback","pages":[{"title":"Send Feedback","api":"POST /v0/feedback","href":"/api-reference/feedback/send"}]},{"group":"Table Rows","pages":[{"title":"Get Table Rows","api":"GET /v0/artifacts/{artifactId}/rows","href":"/api-reference/table-rows/get-rows"},{"title":"Append Rows","api":"POST /v0/artifacts/{artifactId}/rows","href":"/api-reference/table-rows/append-rows"},{"title":"Update Row","api":"PUT /v0/rows/{rowId}","href":"/api-reference/table-rows/update-row"},{"title":"Delete Rows","api":"DELETE /v0/rows","href":"/api-reference/table-rows/delete-rows"}]},{"group":"Versions","pages":[{"title":"Publish Version","api":"POST /v0/artifacts/{artifactId}/versions","href":"/api-reference/versions/publish"},{"title":"Append to a File","api":"POST /v0/artifacts/{artifactId}/append","href":"/api-reference/versions/append"},{"title":"List Versions","api":"GET /v0/artifacts/{artifactId}/versions","href":"/api-reference/versions/list"},{"title":"Get Version","api":"GET /v0/versions/{versionId}","href":"/api-reference/versions/get"},{"title":"Get Version Content","api":"GET /v0/versions/{versionId}/content","href":"/api-reference/versions/get-content"},{"title":"Diff Version","api":"GET /v0/diffs","href":"/api-reference/versions/diff"},{"title":"Delete Version","api":"DELETE /v0/versions/{versionId}","href":"/api-reference/versions/delete"},{"title":"Prune Versions","api":"DELETE /v0/artifacts/{artifactId}/versions","href":"/api-reference/versions/prune"}]},{"group":"Tasks","pages":[{"title":"List Tasks","api":"GET /v0/tasks","href":"/api-reference/tasks/list"},{"title":"Create Task","api":"POST /v0/tasks","href":"/api-reference/tasks/create"},{"title":"Get Task","api":"GET /v0/tasks/{id}","href":"/api-reference/tasks/get"},{"title":"Update and Transition Tasks","href":"/api-reference/tasks/transitions"},{"title":"Propose, Report and Decide","href":"/api-reference/tasks/review"},{"title":"Messages","href":"/api-reference/messages"},{"title":"Jobs","href":"/api-reference/jobs"},{"title":"Outputs","href":"/api-reference/outputs"}]},{"group":"Activity","pages":[{"title":"Read Activity","api":"GET /v0/activity","href":"/api-reference/activity/list"}]},{"group":"Search","pages":[{"title":"Search","api":"GET /v0/search","href":"/api-reference/search/search"}]},{"group":"Health","pages":[{"title":"Health Check","api":"GET /v0/health","href":"/api-reference/health/check"}]}]}]},"basePath":"","title":"Sign In - Tokenrip","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}