Skip to navigation

Vend Amazon access token

Use the canonical authorization ID from list identities. Requires an API-key-derived JWT or delegated human OAuth app token, plus live authorization and commercial entitlement. Human access is bound to the original organization and registered source provider; machine policy is unchanged. Returns an Amazon access token, not a Kuudo JWT. Keep it server-side and honor expires_at. Responses use Cache-Control: no-store.

Requires every scope: amazon-tokens:vend.

Authentication

AuthorizationBearer

JWT returned by POST /api/auth/token-exchange. Amazon, authorization invitations, and developer credentials require API-key-derived tokens.

Path parameters

idintegerRequired1-2147483647

Storage/server/environment resource ID as applicable.

Request

This endpoint expects an object.
providerenumOptional
Allowed values:
profile_idstringOptional

Optional Ads profile ID; profileId is accepted as a compatibility alias.

force_refreshbooleanOptionalDefaults to false

Request a fresh Amazon access token instead of reusing the shared credential cache. Uses the same authorization and tenant checks. Consumers may use this once after Amazon rejects an issued access token; it does not restore revoked permissions or retry the Amazon operation.

Response

Success
access_tokenstring

Amazon access token. Keep server-side and never log it.

expires_atdatetime
client_idstring
regionstring
base_urlstringformat: "uri"
providerenum
Allowed values:
profileslist of objectsOptional
selling_partner_idstringOptional
selling_partner_typeenumOptional
Allowed values:
authorization_marketplaceenumOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error
503
Service Unavailable Error