Executors

Atomically rotate an executor credential

Requires a server-authenticated tenant owner/operator with executors:manage. Agent API keys are rejected. The old credential is revoked before the replacement plaintext is returned once.

post/v1/executors/{id}/credentials/rotate

Request

  • Base URL: https://api.thrd.email
  • URL: https://api.thrd.email/v1/executors/{id}/credentials/rotate
  • Auth: API key in header x-admin-token

Path parameters

idstring required

Request body

current_credential_idstring required

Response

Credential rotated; replacement plaintext returned once

principal_idstring required
credential_idstring required
environment'development' | 'staging' | 'production' required
credential_tokenstring required

Changes

No recorded changes to this operation across all 1 revision of this API.