Skip to navigation

What the create route takes

Beta

What POST /api/v0/assets/create takes beyond its documented body, by capability name. create-idempotency-keys: every server of this Athena honours the create’s Idempotency-Key, so a create whose answer was lost (a timeout, a dropped connection, a gateway’s 502, 503 or 504) may be sent again with the same key and is answered with the asset the first request made. A server names nothing for 30 minutes after it starts, longer than a rollout takes, so a client never sends a create again while a server that would create a second asset can still receive it. The answer says what this Athena’s code does, never anything about you or your data, and is never cached.

Authentication

X-API-KEYstring
API Key authentication via header

Headers

X-Athena-Session-CredentialstringOptional

Response

Successful Response
capabilitieslist of strings

Capability names. create-idempotency-keys: every server of this Athena honours the create’s Idempotency-Key, so a create whose answer was lost may be sent again with its key. A server names nothing for a while after it starts, until a rollout that replaces servers without it has had time to finish.