List available agent profiles (presets)

Returns the catalog of agent profiles (simple, workflow, agent_light, agent_full, orchestrator) with their feature flags, limits, and recommended use cases.

GET /v1/profiles

List available agent profiles (presets)

cURL

curl --request GET \
  --url https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/profiles \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/profiles', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://{host}/v2/workspaces/slug:agent-factory/webhooks/v1/profiles"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

200

{
  "items": [
    {
      "description": "<string>",
      "level": "<string>",
      "features": {},
      "limits": {},
      "use_cases": [
        "<string>"
      ]
    }
  ]
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

{
  "error": "<string>",
  "message": "<string>",
  "details": {}
}

Authorizations

BearerAuthOrgApiKeyAuth

Authorization · string · header · required

User-bound credential carrying an identity: either a session JWT or a user access token (at:*) generated from the user settings UI. Send as Authorization: Bearer <token>. Org API keys (iak_*) are not accepted here - they carry no user identity. Use the x-prismeai-api-key header instead (see OrgApiKeyAuth).

Response

200

application/json

Catalog of agent profiles.

items · object[]

Hide child attributes

items. id · enum<string>

Available options: simple, workflow, agent_light, agent_full, orchestrator

items. description · string

items. level · string

items. features · object

items. limits · object

items. use_cases · string[]