Executors

Register an executor and issue its first credential

Requires a server-authenticated tenant owner/operator with executors:manage. Agent API keys are rejected. Tenant, environment, actor, role and scopes are derived server-side and cannot appear in the body.

post/v1/executors

Request

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

Request body

namestring required
tool_namestring required
execution_targetstring required

Response

Executor registered. Store credential_token now; plaintext cannot be fetched again.

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

Secret returned once and stored server-side only as a peppered hash.

Changes

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