Skip to content
Scope

List profiles

GET
/api/v1/profiles
 
curl --request GET \
  --url 'https://example.com/api/v1/profiles?projectId=00000000-0000-0000-0000-000000000000'

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
workerType
string
projectId
required

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

string
>= 1 characters
Example 
00000000-0000-0000-0000-000000000000

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

Media type application/json
Array<object>
object
_id
required
string
name
required
string
description
string
latestVersion
required
number
createdAt
required
string | null format: date-time
updatedAt
string | null format: date-time
deletedAt
string | null format: date-time
version
required
object
_id
required
string
profileId
required
string
version
required
number
workerType
required
string
model
required
string
reasoningEffort
string
agentVersion
string
mcpServers
Array<string>
skillRevisions
Array<string>
extensions
Array<string>
createdAt
required
string | null format: date-time
projectId
required
string
projectId
required
string
Example generated
[
  {
    "_id": "example",
    "name": "example",
    "description": "example",
    "latestVersion": 1,
    "createdAt": "2026-04-15T12:00:00Z",
    "updatedAt": "2026-04-15T12:00:00Z",
    "deletedAt": "2026-04-15T12:00:00Z",
    "version": {
      "_id": "example",
      "profileId": "example",
      "version": 1,
      "workerType": "example",
      "model": "example",
      "reasoningEffort": "example",
      "agentVersion": "example",
      "mcpServers": [
        "example"
      ],
      "skillRevisions": [
        "example"
      ],
      "extensions": [
        "example"
      ],
      "createdAt": "2026-04-15T12:00:00Z",
      "projectId": "example"
    },
    "projectId": "example"
  }
]