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"
}