A valid request URL is required to generate request examples{
"unitAmountMinor": 14900,
"currency": "usd",
"period": {
"interval": "month",
"count": 1
},
"maxQuantity": 500
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "rate_limited",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}Read the monthly robot checkout offer
Requires a first-party signed-in organization session. Records only the initial robot purchase payment receipt; every quantity remains not delivered. No device provisioning, setup or current subscription entitlement is implied.
Hosted deployments only. A local checkout does not mount this route, so calling it there is a 404.
A valid request URL is required to generate request examples{
"unitAmountMinor": 14900,
"currency": "usd",
"period": {
"interval": "month",
"count": 1
},
"maxQuantity": 500
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}{
"error": {
"code": "rate_limited",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"orderId": "<string>",
"retryable": true,
"maxAgeMinutes": 123
}
}Authorizations
The control surface credential. Send Authorization: Bearer <token>.
Two kinds of token are accepted and they are told apart by shape, not by a separate header. A token beginning pbk_ or puk_ is an org scoped API key, whose public half and secret half are generated together and of which only a hash of the secret is ever stored; anything else is treated as an OAuth 2.1 access token and verified against the authorization server's keys.
Both resolve to the same context: an org, a principal and a set of scopes. Nothing downstream branches on which channel you used, with one deliberate exception, key management, which requires a signed-in person so that a key can never mint another key.
Scopes are enforced when MCP tools are REGISTERED rather than when they are called, so a tool your credential cannot use is absent from tools/list rather than refused mid gesture.