Internal Agent · Oblive Docs

Get agent organization status

GET/internal/agent/organizations/{organizationId}/status

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Promote an owner-reviewed chat proposal into Context

POST/internal/agent/organizations/{organizationId}/context/promotions

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

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/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/context/promotions" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 201,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Promote a human-approved structured Context revision

POST/internal/agent/organizations/{organizationId}/tasks/{taskRef}/context-revisions/promote

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/context-revisions/promote" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

List tasks for agents

GET/internal/agent/organizations/{organizationId}/tasks

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Create task as an agent

POST/internal/agent/organizations/{organizationId}/tasks

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

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/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 201,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Get task by reference

GET/internal/agent/organizations/{organizationId}/tasks/{taskRef}

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Safely update task planning fields

PATCH/internal/agent/organizations/{organizationId}/tasks/{taskRef}

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

List task prerequisites and dependents

GET/internal/agent/organizations/{organizationId}/tasks/{taskRef}/dependencies

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Add a planning dependency

POST/internal/agent/organizations/{organizationId}/tasks/{taskRef}/dependencies

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/dependencies" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 201,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Cancel task subtree and active executions

POST/internal/agent/organizations/{organizationId}/tasks/{taskRef}/cancel

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/cancel" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Ask or notify a human

POST/internal/agent/organizations/{organizationId}/tasks/{taskRef}/human-inbox

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/human-inbox" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 201,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Stage a typed plan or outcome for the active task run

POST/internal/agent/organizations/{organizationId}/tasks/{taskRef}/outcomes

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

taskRef*string

Task UUID or identifier.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/tasks/string/outcomes" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 201,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

List schedules for agents

GET/internal/agent/organizations/{organizationId}/schedules

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Create schedule as an agent

POST/internal/agent/organizations/{organizationId}/schedules

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

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/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules" \  -H "Content-Type: application/json" \  -d '{}'

{  "success": true,  "statusCode": 201,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Pause schedule

POST/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}/pause

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

scheduleRef*string

Schedule UUID or stable key.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string/pause"

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Resume schedule

POST/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}/resume

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

scheduleRef*string

Schedule UUID or stable key.

Response Body

`application/json`

curl -X POST "https://example.com/internal/agent/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/schedules/string/resume"

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

Delete schedule

DELETE/internal/agent/organizations/{organizationId}/schedules/{scheduleRef}

Authorization

AuthorizationBearer <token>

Token used by trusted agent runtimes.

In: header

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

scheduleRef*string

Schedule UUID or stable key.

Response Body

`application/json`

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

{  "success": true,  "statusCode": 200,  "message": "Control-plane operation completed.",  "data": {}}

{  "success": false,  "statusCode": 400,  "message": "Validation failed.",  "error": {    "code": "validation_failed"  }}

{  "success": false,  "statusCode": 401,  "message": "Invalid agent service token or execution capability.",  "error": {    "code": "agent_unauthorized"  }}

{  "success": false,  "statusCode": 404,  "message": "Control-plane entity was not found.",  "error": {    "code": "not_found"  }}

{  "success": false,  "statusCode": 409,  "message": "Control-plane state conflict.",  "error": {    "code": "state_conflict"  }}

200application/json

400application/json

401application/json

404application/json

409application/json

201application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

201application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

201application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

201application/json

400application/json

401application/json

404application/json

409application/json

201application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

201application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/json

401application/json

404application/json

409application/json

200application/json

400application/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`

`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`

`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`

`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`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`