Skip to content

Hands the code shown on Claude's sign-in page, or the API key a needs_key login waits for, to the waiting login and answers once the tool says whether it is signed in.

POST
/v1/m/agenttools/sign-in/{id}/code
curl --request POST \
--url https://example.com/v1/m/agenttools/sign-in/example/code \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "code": "example" }'

Hands the code shown on Claude’s sign-in page, or the API key a needs_key login waits for, to the waiting login and answers once the tool says whether it is signed in.

id
required
string

Path parameter id.

Media type application/json
object
code
required

The code the sign-in page shows (needs_code), or the API key the tool’s own login waits for (needs_key). It goes to the tool’s stdin and is never stored, logged or returned.

string
<= 2048 characters
Example generated
{
"code": "example"
}

The pasted code or key was handed to the tool

Media type application/json
object
account_ref
string
driver
required
string
id
required
string format: uuid
message
string
state
required
string
Allowed values: starting needs_code needs_key waiting checking signed_in failed
url
string
user_code
string
Example
{
"state": "starting"
}

Bad request

Media type application/json
object
Example generated
{}

Unauthenticated

Media type application/json
object
Example generated
{}

Forbidden / step-up required

Media type application/json
object
Example generated
{}

Not found

Media type application/json
object
Example generated
{}

Conflict

Media type application/json
object
Example generated
{}

Required evidence or store unavailable

Media type application/json
object
Example generated
{}