A valid request URL is required to generate request examples{
"purchases": [
{
"orderId": "<string>",
"quantity": 500,
"paymentStatus": "pending",
"deliveryStatus": "not_delivered",
"unitAmountMinor": 9900,
"currency": "usd",
"paidTotalMinor": 1,
"paidAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}
]
}{
"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
}
}List your robot purchases
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. Newest first, at most 100, for this workspace and sign-in instance only. Includes unpaid, expired and review states; each row is the same receipt summary as the single read, plus createdAt.
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{
"purchases": [
{
"orderId": "<string>",
"quantity": 500,
"paymentStatus": "pending",
"deliveryStatus": "not_delivered",
"unitAmountMinor": 9900,
"currency": "usd",
"paidTotalMinor": 1,
"paidAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z"
}
]
}{
"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.