Skip to main content

Create Background Agent

POST 
/api/background-agents

Creates a new background agent in your organization.

The response includes the agent's access_key and a one-time plaintext secret. Store the secret securely — it is never returned again. The agent authenticates to the gateway with Authorization: Bearer <access_key>:<secret>.

Request​

Responses​

Background agent created successfully. The secret field is only returned on creation.