<Intro>

<EndpointHeader />

<Description>

Revokes a key. The key stops working immediately; the record is retained with revoked_at set for audit. Only revoke a key once it is no longer in use. Returns the updated key. Returns 409 if the key is already revoked, and 422 if it is the app's only key (an app must keep at least one).

</Description>

</Intro>

<Payload kind="response">

<Field name="id" type="string" required />

<Field name="key" type="string" required>

<Description>

The public app key clients use to connect.

</Description>

</Field>

<Field name="secret" type="string">

<Description>

The key secret, used for server-side request signing. Returned only when the key is created, and never shown again — store it securely. If lost, create a new key and revoke this one.

</Description>

</Field>

<Field name="revoked_at" type="nullable string" required>

<Description>

When the key was revoked, or null if still active.

</Description>

</Field>

<Field name="created_at" type="string" required />

</Payload>