Skip to main content
POST
/
v1
/
agents
curl -X POST https://api.saturn-pay.com/v1/agents \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "worker-2"
  }'
{
  "id": "agt_ghi789",
  "name": "worker-2",
  "apiKey": "sk_agt_new_key_here_abc123def456",
  "killed": false,
  "createdAt": "2024-01-20T15:00:00Z"
}
Creates a new agent under your account. Returns the agent details including a new API key.
The API key is only returned once. Store it securely.

Request

name
string
required
Name for the agent. Used for identification in logs and dashboard.

Response

id
string
Unique agent identifier
name
string
Agent name
apiKey
string
API key for this agent. Only returned on creation.
createdAt
string
ISO 8601 timestamp
curl -X POST https://api.saturn-pay.com/v1/agents \
  -H "Authorization: Bearer sk_agt_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "worker-2"
  }'
{
  "id": "agt_ghi789",
  "name": "worker-2",
  "apiKey": "sk_agt_new_key_here_abc123def456",
  "killed": false,
  "createdAt": "2024-01-20T15:00:00Z"
}