Skip to main content
POST
/
agent-profile-pools
Create Agent Profile Pool
curl --request POST \
  --url https://odyssey.asteroid.ai/agents/v2/agent-profile-pools \
  --header 'Content-Type: application/json' \
  --header 'X-Asteroid-Agents-Api-Key: <api-key>' \
  --data '
{
  "name": "<string>",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "allowConcurrentUse": false,
  "selectionStrategy": "least_recently_used"
}
'
{
  "allowConcurrentUse": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "organizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "updatedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.asteroid.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Asteroid-Agents-Api-Key
string
header
required

Body

application/json

Agent profile pool to create

Request to create a new agent profile pool

​
name
string
required

Name of the agent profile pool (must be unique within organization)

Required string length: 1 - 255
​
organizationId
string<uuid>
required

The ID of the organization that the pool belongs to

​
allowConcurrentUse
boolean
default:false

Whether multiple executions can use the same profile concurrently

​
selectionStrategy
enum<string>
default:least_recently_used

Strategy for selecting an available profile from the pool

Available options:
least_recently_used,
most_recently_used

Response

The request has succeeded and a new resource has been created as a result.

A pool of agent profiles that can be used for credential rotation

​
allowConcurrentUse
boolean
required

Whether multiple executions can use the same profile concurrently

​
createdAt
string<date-time>
required

When the pool was created

​
id
string<uuid>
required

Unique identifier for the agent profile pool

​
name
string
required

Name of the agent profile pool (unique within organization)

​
organizationId
string<uuid>
required

The ID of the organization that owns this pool

​
selectionStrategy
enum<string>
required

Strategy for selecting an available profile from the pool

Available options:
least_recently_used,
most_recently_used
​
updatedAt
string<date-time>
required

When the pool was last updated