Agent Profiles · Oblive Docs

List agent profiles

GET/organizations/{organizationId}/agent-profiles

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Query Parameters

cursor?string

Formatuuid

limit?integer

sortBy?string

Value in

"id"
"key"
"name"
"kind"
"status"
"createdAt"

sortDirection?string

Value in

"asc"
"desc"

key?string

kind?string

Value in

"operator"
"chat"
"department"

department?string

Value in

"growth"
"engineering"
"support"

status?string

Value in

"enabled"
"disabled"

Response Body

`application/json`

curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-profiles"

{  "success": true,  "statusCode": 200,  "message": "Agent profiles listed.",  "data": [    {      "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",      "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",      "key": "growth",      "name": "Growth",      "kind": "department",      "department": "growth",      "status": "enabled",      "rootUri": "memory://organizations/acme/agents/growth",      "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",      "config": {        "defaultRunMode": "execute",        "maxConcurrentRuns": 2,        "toolPolicyKeys": [          "growth-default"        ],        "memoryRootUri": "memory://organizations/acme/agents/growth",        "skillKeys": [          "operational-durability",          "growth-operations"        ],        "mcpServerKeys": [],        "catalogSource": {          "templateKey": "growth",          "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"        }      },      "createdAt": "2026-01-01T00:00:00.000Z",      "updatedAt": "2026-01-01T00:00:00.000Z"    }  ],  "pagination": {    "cursor": null,    "limit": 50,    "nextCursor": null,    "previousCursor": null,    "hasNextPage": false,    "hasPreviousPage": false  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Create agent profile

POST/organizations/{organizationId}/agent-profiles

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-profiles" \  -H "Content-Type: application/json" \  -d '{    "key": "growth",    "name": "Growth",    "kind": "department",    "department": "growth",    "status": "enabled",    "rootUri": "memory://organizations/acme/agents/growth",    "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",    "config": {      "defaultRunMode": "execute",      "maxConcurrentRuns": 2,      "toolPolicyKeys": [        "growth-default"      ],      "memoryRootUri": "memory://organizations/acme/agents/growth",      "skillKeys": [        "operational-durability",        "growth-operations"      ],      "mcpServerKeys": [],      "catalogSource": {        "templateKey": "growth",        "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"      }    }  }'

{  "success": true,  "statusCode": 201,  "message": "Agent profile created.",  "data": {    "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",    "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "key": "growth",    "name": "Growth",    "kind": "department",    "department": "growth",    "status": "enabled",    "rootUri": "memory://organizations/acme/agents/growth",    "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",    "config": {      "defaultRunMode": "execute",      "maxConcurrentRuns": 2,      "toolPolicyKeys": [        "growth-default"      ],      "memoryRootUri": "memory://organizations/acme/agents/growth",      "skillKeys": [        "operational-durability",        "growth-operations"      ],      "mcpServerKeys": [],      "catalogSource": {        "templateKey": "growth",        "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"      }    },    "createdAt": "2026-01-01T00:00:00.000Z",    "updatedAt": "2026-01-01T00:00:00.000Z"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Get agent profile

GET/organizations/{organizationId}/agent-profiles/{id}

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

id*string

Resource identifier.

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "success": true,  "statusCode": 200,  "message": "Agent profile found.",  "data": {    "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",    "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "key": "growth",    "name": "Growth",    "kind": "department",    "department": "growth",    "status": "enabled",    "rootUri": "memory://organizations/acme/agents/growth",    "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",    "config": {      "defaultRunMode": "execute",      "maxConcurrentRuns": 2,      "toolPolicyKeys": [        "growth-default"      ],      "memoryRootUri": "memory://organizations/acme/agents/growth",      "skillKeys": [        "operational-durability",        "growth-operations"      ],      "mcpServerKeys": [],      "catalogSource": {        "templateKey": "growth",        "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"      }    },    "createdAt": "2026-01-01T00:00:00.000Z",    "updatedAt": "2026-01-01T00:00:00.000Z"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 404,  "message": "Agent profile not found.",  "error": {    "code": "agent_profile_not_found"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Update agent profile

PATCH/organizations/{organizationId}/agent-profiles/{id}

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

id*string

Resource identifier.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X PATCH "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "name": "Growth Team"  }'

{  "success": true,  "statusCode": 200,  "message": "Agent profile updated.",  "data": {    "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",    "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "key": "growth",    "name": "Growth",    "kind": "department",    "department": "growth",    "status": "enabled",    "rootUri": "memory://organizations/acme/agents/growth",    "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",    "config": {      "defaultRunMode": "execute",      "maxConcurrentRuns": 2,      "toolPolicyKeys": [        "growth-default"      ],      "memoryRootUri": "memory://organizations/acme/agents/growth",      "skillKeys": [        "operational-durability",        "growth-operations"      ],      "mcpServerKeys": [],      "catalogSource": {        "templateKey": "growth",        "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"      }    },    "createdAt": "2026-01-01T00:00:00.000Z",    "updatedAt": "2026-01-01T00:00:00.000Z"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 404,  "message": "Agent profile not found.",  "error": {    "code": "agent_profile_not_found"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

Delete agent profile

DELETE/organizations/{organizationId}/agent-profiles/{id}

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

id*string

Resource identifier.

Formatuuid

Response Body

`application/json`

curl -X DELETE "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-profiles/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "success": true,  "statusCode": 200,  "message": "Agent profile deleted.",  "data": {    "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",    "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "key": "growth",    "name": "Growth",    "kind": "department",    "department": "growth",    "status": "enabled",    "rootUri": "memory://organizations/acme/agents/growth",    "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",    "config": {      "defaultRunMode": "execute",      "maxConcurrentRuns": 2,      "toolPolicyKeys": [        "growth-default"      ],      "memoryRootUri": "memory://organizations/acme/agents/growth",      "skillKeys": [        "operational-durability",        "growth-operations"      ],      "mcpServerKeys": [],      "catalogSource": {        "templateKey": "growth",        "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"      }    },    "createdAt": "2026-01-01T00:00:00.000Z",    "updatedAt": "2026-01-01T00:00:00.000Z"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 404,  "message": "Agent profile not found.",  "error": {    "code": "agent_profile_not_found"  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

List current agent profile templates

GET/agent-profile-templates

Response Body

`application/json`

curl -X GET "https://example.com/agent-profile-templates"

{  "success": true,  "statusCode": 200,  "message": "Agent profile templates found.",  "data": {    "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "catalog": {      "version": 1,      "commonSkillKeys": [        "operational-durability"      ],      "commonMcpServerKeys": [],      "profiles": [        {          "key": "growth",          "name": "Growth",          "summary": "Owns acquisition, activation, retention, and growth experimentation work.",          "kind": "department",          "department": "growth",          "skillKeys": [            "growth-operations"          ],          "mcpServerKeys": [],          "config": {            "defaultRunMode": "execute",            "maxConcurrentRuns": 1,            "toolPolicyKeys": []          }        }      ]    }  },  "meta": {    "timestamp": "2026-07-14T10:00:00.000Z"  }}

{  "success": false,  "statusCode": 503,  "message": "No agent-pack catalog has been published.",  "error": {    "code": "request_failed"  },  "meta": {    "timestamp": "2026-07-14T10:00:00.000Z"  }}

Provision organization agent profiles

POST/organizations/{organizationId}/agent-profiles/provision

Pins operator, chat, and selected department profiles to an immutable catalog revision.

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/agent-profiles/provision" \  -H "Content-Type: application/json" \  -d '{    "departments": [      "growth"    ]  }'

{  "success": true,  "statusCode": 200,  "message": "Agent profiles updated.",  "data": {    "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "profiles": [      {        "id": "8abf91f2-5785-44c7-bfb2-508fa85a8f8d",        "organizationId": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",        "key": "growth",        "name": "Growth",        "kind": "department",        "department": "growth",        "status": "enabled",        "rootUri": "memory://organizations/acme/agents/growth",        "instructionsUri": "memory://organizations/acme/agents/growth/instructions.md",        "config": {          "defaultRunMode": "execute",          "maxConcurrentRuns": 2,          "toolPolicyKeys": [            "growth-default"          ],          "memoryRootUri": "memory://organizations/acme/agents/growth",          "skillKeys": [            "operational-durability",            "growth-operations"          ],          "mcpServerKeys": [],          "catalogSource": {            "templateKey": "growth",            "revision": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"          }        },        "createdAt": "2026-01-01T00:00:00.000Z",        "updatedAt": "2026-01-01T00:00:00.000Z"      }    ],    "disabledProfileIds": []  },  "meta": {    "timestamp": "2026-07-14T10:00:00.000Z"  }}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed",    "issues": [      {        "path": "organizationId",        "message": "Must be a valid UUID.",        "code": "invalid_format"      }    ]  },  "meta": {    "timestamp": "2026-01-01T00:00:00.000Z"  }}

{  "success": false,  "statusCode": 404,  "message": "Organization not found.",  "error": {    "code": "request_failed"  },  "meta": {    "timestamp": "2026-07-14T10:00:00.000Z"  }}

200application/json

400application/json

201application/json

400application/json

200application/json

400application/json

404application/json

200application/json

400application/json

404application/json

200application/json

400application/json

404application/json

200application/json

503application/json

200application/json

400application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`