Operation details
GET /v1/admin/traffic-packages/grants
List grants for one explicit tenant
- operationId
listTenantTrafficPackageGrants- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
listTenantTrafficPackageGrants Parameters| Name | In | Type | Required | Description |
|---|
tenant_id | query | string(uuid) | Yes | Explicit access-scope UUID of the target tenant. |
|---|
limit | query | integer | No | — |
|---|
cursor | query | string | No | Opaque HMAC-signed cursor bound to endpoint, principal scope, target tenant, owner user, UTC-microsecond snapshot_at, and the applicable migration-066 catalog/usage snapshot_version or grant-state watermark. |
|---|
Responses
listTenantTrafficPackageGrants Responses| Status | Description |
|---|
200 | Grants visible under the derived or explicit tenant scope. Fields：items: array<Grant> next_cursor?: string total?: integer(int64) |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
408 | Read context was cancelled. |
|---|
502 | Stored or core facts did not satisfy the public response contract. |
|---|
503 | Read storage is unavailable. |
|---|
504 | Read deadline expired. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
POST /v1/admin/traffic-packages/grants/{grant_id}/disable
Pause deduction without changing remaining bytes or expiry
- operationId
disableSoldTrafficPackage- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.manage
Parameters
disableSoldTrafficPackage Parameters| Name | In | Type | Required | Description |
|---|
grant_id | path | string(uuid) | Yes | — |
|---|
Idempotency-Key | header | string | Yes | — |
|---|
X-Request-ID | header | string | Yes | — |
|---|
traceparent | header | string | Yes | — |
|---|
Responses
disableSoldTrafficPackage Responses| Status | Description |
|---|
200 | Immutable audited command receipt; identical retries return the same fact. Fields：id: string(uuid) target_id: string(uuid) operation: string: archive_product / enable_grant / disable_grant revision: integer replayed: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
409 | Idempotency, refund amount, grant-state, or bounded automatic-expiry backlog conflict. For traffic_package_expiry_backlog the original key replays the frozen result and a new caller-generated key advances at most the next 100 due grants. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
POST /v1/admin/traffic-packages/grants/{grant_id}/enable
Resume deduction for an unexpired active grant
- operationId
enableSoldTrafficPackage- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.manage
Parameters
enableSoldTrafficPackage Parameters| Name | In | Type | Required | Description |
|---|
grant_id | path | string(uuid) | Yes | — |
|---|
Idempotency-Key | header | string | Yes | — |
|---|
X-Request-ID | header | string | Yes | — |
|---|
traceparent | header | string | Yes | — |
|---|
Responses
enableSoldTrafficPackage Responses| Status | Description |
|---|
200 | Immutable audited command receipt; identical retries return the same fact. Fields：id: string(uuid) target_id: string(uuid) operation: string: archive_product / enable_grant / disable_grant revision: integer replayed: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
409 | Idempotency, refund amount, grant-state, or bounded automatic-expiry backlog conflict. For traffic_package_expiry_backlog the original key replays the frozen result and a new caller-generated key advances at most the next 100 due grants. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
GET /v1/admin/traffic-packages/grants/{grant_id}/reconciliation
Compare one grant's cached and ledger-recomputed balance
- operationId
reconcileTenantTrafficPackageGrant- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
reconcileTenantTrafficPackageGrant Parameters| Name | In | Type | Required | Description |
|---|
grant_id | path | string(uuid) | Yes | — |
|---|
tenant_id | query | string(uuid) | Yes | Explicit access-scope UUID of the target tenant. |
|---|
Responses
reconcileTenantTrafficPackageGrant Responses| Status | Description |
|---|
200 | Cached and recomputed grant balance comparison. Fields：grant_id: string(uuid) cached_remaining: integer(int64) recomputed_remaining: integer(int64) cached_revision: integer(int64) entry_count: integer(int64) consistent: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
408 | Read context was cancelled. |
|---|
502 | Stored or core facts did not satisfy the public response contract. |
|---|
503 | Read storage is unavailable. |
|---|
504 | Read deadline expired. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
GET /v1/admin/traffic-packages/options
Search base or traffic product names for management selectors
- operationId
listTrafficPackageManagementOptions- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
listTrafficPackageManagementOptions Parameters| Name | In | Type | Required | Description |
|---|
kind | query | string: base / traffic | Yes | — |
|---|
search | query | string | No | — |
|---|
Responses
listTrafficPackageManagementOptions Responses| Status | Description |
|---|
200 | Up to 100 matching names; traffic options include archived products for historical sold filters. Fields：items: array<object> |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
GET /v1/admin/traffic-packages/products
List current product revisions
- operationId
listCurrentTrafficPackageProducts- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
listCurrentTrafficPackageProducts Parameters| Name | In | Type | Required | Description |
|---|
limit | query | integer | No | — |
|---|
cursor | query | string | No | Opaque HMAC-signed cursor bound to endpoint, principal scope, target tenant, owner user, UTC-microsecond snapshot_at, and the applicable migration-066 catalog/usage snapshot_version or grant-state watermark. |
|---|
Responses
listCurrentTrafficPackageProducts Responses| Status | Description |
|---|
200 | Current products or immutable revision history. Fields：items: array<Product> next_cursor?: string |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
408 | Read context was cancelled. |
|---|
502 | Stored or core facts did not satisfy the public response contract. |
|---|
503 | Read storage is unavailable. |
|---|
504 | Read deadline expired. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
GET /v1/admin/traffic-packages/products/{product_id}
Get the current revision of one product
- operationId
getCurrentTrafficPackageProduct- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
getCurrentTrafficPackageProduct Parameters| Name | In | Type | Required | Description |
|---|
product_id | path | string(uuid) | Yes | — |
|---|
Responses
getCurrentTrafficPackageProduct Responses| Status | Description |
|---|
200 | Current product revision. Fields：id: string(uuid) product_id: string(uuid) revision: integer(int64) audience: string: global / tenant owner_tenant_scope_id?: string(uuid) name: string remark?: string allowed_package_ids?: array<string(uuid)> quota_bytes: integer(int64) validity_days: integer expiry_timezone: string priority: integer currency: string price_minor: integer(int64) metering_scope: string metering_version: string created_at: string(date-time) enabled: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
408 | Read context was cancelled. |
|---|
502 | Stored or core facts did not satisfy the public response contract. |
|---|
503 | Read storage is unavailable. |
|---|
504 | Read deadline expired. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
POST /v1/admin/traffic-packages/products/{product_id}/archive
Remove a product from sale while preserving sold entitlements and history
- operationId
archiveTrafficPackageProduct- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.manage
Parameters
archiveTrafficPackageProduct Parameters| Name | In | Type | Required | Description |
|---|
product_id | path | string(uuid) | Yes | — |
|---|
Idempotency-Key | header | string | Yes | — |
|---|
X-Request-ID | header | string | Yes | — |
|---|
traceparent | header | string | Yes | — |
|---|
Responses
archiveTrafficPackageProduct Responses| Status | Description |
|---|
200 | Immutable audited command receipt; identical retries return the same fact. Fields：id: string(uuid) target_id: string(uuid) operation: string: archive_product / enable_grant / disable_grant revision: integer replayed: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
409 | Idempotency, refund amount, grant-state, or bounded automatic-expiry backlog conflict. For traffic_package_expiry_backlog the original key replays the frozen result and a new caller-generated key advances at most the next 100 due grants. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
POST /v1/admin/traffic-packages/products/{product_id}/disable
Disable a product
- operationId
disableTrafficPackageProduct- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.manage
Description (from the contract)
Appends a disabled lifecycle fact. Disabled products disappear from tenant current-product lists and cannot receive new grants; immutable revision history remains readable.
Parameters
disableTrafficPackageProduct Parameters| Name | In | Type | Required | Description |
|---|
product_id | path | string(uuid) | Yes | — |
|---|
Idempotency-Key | header | string | Yes | — |
|---|
X-Request-ID | header | string | Yes | — |
|---|
traceparent | header | string | Yes | — |
|---|
Responses
disableTrafficPackageProduct Responses| Status | Description |
|---|
200 | Appended lifecycle fact or identical committed replay. Fields：product_id: string(uuid) product_revision: integer(int64) revision: integer(int64) sequence: integer(int64) enabled: boolean replayed: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
409 | Idempotency, refund amount, grant-state, or bounded automatic-expiry backlog conflict. For traffic_package_expiry_backlog the original key replays the frozen result and a new caller-generated key advances at most the next 100 due grants. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
POST /v1/admin/traffic-packages/products/{product_id}/enable
Enable a product
- operationId
enableTrafficPackageProduct- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.manage
Description (from the contract)
Appends an enabled lifecycle fact. Reusing the same idempotency key and payload returns the original receipt; a changed payload returns 409.
Parameters
enableTrafficPackageProduct Parameters| Name | In | Type | Required | Description |
|---|
product_id | path | string(uuid) | Yes | — |
|---|
Idempotency-Key | header | string | Yes | — |
|---|
X-Request-ID | header | string | Yes | — |
|---|
traceparent | header | string | Yes | — |
|---|
Responses
enableTrafficPackageProduct Responses| Status | Description |
|---|
200 | Appended lifecycle fact or identical committed replay. Fields：product_id: string(uuid) product_revision: integer(int64) revision: integer(int64) sequence: integer(int64) enabled: boolean replayed: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
409 | Idempotency, refund amount, grant-state, or bounded automatic-expiry backlog conflict. For traffic_package_expiry_backlog the original key replays the frozen result and a new caller-generated key advances at most the next 100 due grants. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
GET /v1/admin/traffic-packages/products/{product_id}/revisions
List immutable product revision history
- operationId
listTrafficPackageProductRevisions- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
listTrafficPackageProductRevisions Parameters| Name | In | Type | Required | Description |
|---|
product_id | path | string(uuid) | Yes | — |
|---|
limit | query | integer | No | — |
|---|
cursor | query | string | No | Opaque HMAC-signed cursor bound to endpoint, principal scope, target tenant, owner user, UTC-microsecond snapshot_at, and the applicable migration-066 catalog/usage snapshot_version or grant-state watermark. |
|---|
Responses
listTrafficPackageProductRevisions Responses| Status | Description |
|---|
200 | Current products or immutable revision history. Fields：items: array<Product> next_cursor?: string |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
408 | Read context was cancelled. |
|---|
502 | Stored or core facts did not satisfy the public response contract. |
|---|
503 | Read storage is unavailable. |
|---|
504 | Read deadline expired. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
POST /v1/admin/traffic-packages/products/{product_id}/revisions
Create an immutable product revision
- operationId
createTrafficPackageProductRevision- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.manage
Description (from the contract)
Publishes the next immutable revision with transactional platform IAM. The quoted If-Match value is the expected current revision (zero creates a new product). Reusing the same Idempotency-Key with the same canonical payload returns the original 201 receipt and Idempotency-Replayed: true; different input returns 409 and a stale expected revision returns 412.
Parameters
createTrafficPackageProductRevision Parameters| Name | In | Type | Required | Description |
|---|
product_id | path | string(uuid) | Yes | — |
|---|
If-Match | header | string | Yes | — |
|---|
Idempotency-Key | header | string | Yes | — |
|---|
X-Request-ID | header | string | Yes | — |
|---|
traceparent | header | string | Yes | — |
|---|
Request body
application/json · Required：Yes
createTrafficPackageProductRevision Request body| Name | Type | Required | Description |
|---|
audience | string: global / tenant | Yes | — |
|---|
owner_tenant_scope_id | string(uuid) | No | — |
|---|
name | string | Yes | — |
|---|
remark | string | No | Maximum 1024 UTF-8 bytes; no control characters. |
|---|
allowed_package_ids | array<string(uuid)> | No | Empty means all base packages. Restrictions are captured per immutable revision and checked for purchase and consumption. |
|---|
quota_bytes | integer(int64) | Yes | — |
|---|
validity_days | integer | Yes | — |
|---|
expiry_timezone | string | Yes | — |
|---|
priority | integer | Yes | — |
|---|
currency | string | Yes | — |
|---|
price_minor | integer(int64) | Yes | — |
|---|
metering_scope | string | Yes | — |
|---|
metering_version | string | Yes | — |
|---|
enabled | boolean | No | Omit to retain current status; defaults to enabled for new products. |
|---|
Responses
createTrafficPackageProductRevision Responses| Status | Description |
|---|
201 | New immutable revision or the identical committed replay. Fields：product_snapshot_id: string(uuid) product_id: string(uuid) revision: integer(int64) replayed: boolean |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
404 | Resource is absent or not visible in the authorized scope. |
|---|
408 | Write result is unknown. Retry only with the same Idempotency-Key and identical payload. |
|---|
409 | Idempotency, refund amount, grant-state, or bounded automatic-expiry backlog conflict. For traffic_package_expiry_backlog the original key replays the frozen result and a new caller-generated key advances at most the next 100 due grants. |
|---|
412 | The quoted If-Match revision is stale. |
|---|
502 | The command committed but its bounded receipt could not be delivered. Recover only by retrying the same Idempotency-Key and identical payload. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
504 | Write result is unknown. Retry only with the same Idempotency-Key and identical payload. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.404 The resource does not exist or belongs to another tenant.409 Read the current state first; a retry of the same operation keeps the original Idempotency-Key and body.412 The revision changed: read the latest ETag, decide again, then send the new If-Match.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list
GET /v1/admin/traffic-packages/sold
List sold grants across tenants with server-side filters and count
- operationId
listSoldTrafficPackages- Auth
- Session: the Bearer session of a signed-in control plane user, used by the customer in their own control plane; a plugin must never ask for it.
- Required permissions
All of：traffic_packages.read
Parameters
listSoldTrafficPackages Parameters| Name | In | Type | Required | Description |
|---|
page | query | integer | No | — |
|---|
limit | query | integer | No | — |
|---|
search | query | string | No | User name |
|---|
product_id | query | string(uuid) | No | — |
|---|
status | query | string: active / disabled / exhausted / expired / reversed | No | — |
|---|
Responses
listSoldTrafficPackages Responses| Status | Description |
|---|
200 | Count and items use one database statement snapshot; pages reflect live state. Fields：items: array<SoldItem> total: integer page: integer limit: integer |
|---|
400 | Malformed headers, query, JSON, UUID, cursor, unit, or range. |
|---|
401 | Ordinary session authentication is required. |
|---|
403 | Principal scope or required permission is absent. |
|---|
503 | The stable error code distinguishes an unavailable dependency or authenticator (no write attempted) from an unknown or committed result. Unknown results require same-key, identical-payload recovery. |
|---|
What to do on failure
400 Fix the parameters or body per the field list; do not retry unchanged.401 Check the credential format and whether it expired or was rotated.403 Check the key scopes, the owner’s current permissions and the tenant scope; never switch to a more privileged account.503 A dependency is unavailable: retry later with the original Idempotency-Key.
↑ Back to list