Organizations · Oblive Docs

List organizations

GET/organizations

Query Parameters

cursor?string

Cursor returned by the previous list call.

Formatuuid

limit?integer

Maximum number of organizations to return.

sortBy?string

Value in

"id"
"slug"
"name"
"createdAt"
"updatedAt"

sortDirection?string

Value in

"asc"
"desc"

Response Body

`application/json`

curl -X GET "https://example.com/organizations"

{  "success": true,  "statusCode": 200,  "message": "Organizations listed.",  "data": [    {      "id": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",      "slug": "acme",      "name": "Acme",      "status": "active",      "onboardedAt": "2026-01-01T00:00:00.000Z",      "rootUri": "memory://organizations/acme",      "authorizationEpoch": 1,      "config": {        "timezone": "UTC",        "departments": {          "growth": {            "enabled": true          },          "engineering": {            "enabled": true          },          "support": {            "enabled": true          }        },        "limits": {          "maxConcurrentRuns": 3,          "maxDailyActions": 100,          "maxTaskDepth": 4,          "maxPlanOperations": 25,          "maxInitiativeDescendants": 100        },        "storageRootUri": "memory://organizations/acme"      },      "constraints": {        "allowedIntegrations": [],        "blockedDomains": [],        "approvalRequiredForRisk": [          "external",          "high"        ]      },      "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",    "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",    "requestId": "4bf92f3577b34da6a3ce929d0e0e4736"  }}

Get an organization

GET/organizations/{organizationId}

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/organizations/7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1"

{  "success": true,  "statusCode": 200,  "message": "Organization found.",  "data": {    "id": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "slug": "acme",    "name": "Acme",    "status": "active",    "onboardedAt": "2026-01-01T00:00:00.000Z",    "rootUri": "memory://organizations/acme",    "authorizationEpoch": 1,    "config": {      "timezone": "UTC",      "departments": {        "growth": {          "enabled": true        },        "engineering": {          "enabled": true        },        "support": {          "enabled": true        }      },      "limits": {        "maxConcurrentRuns": 3,        "maxDailyActions": 100,        "maxTaskDepth": 4,        "maxPlanOperations": 25,        "maxInitiativeDescendants": 100      },      "storageRootUri": "memory://organizations/acme"    },    "constraints": {      "allowedIntegrations": [],      "blockedDomains": [],      "approvalRequiredForRisk": [        "external",        "high"      ]    },    "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",    "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",    "requestId": "4bf92f3577b34da6a3ce929d0e0e4736"  }}

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

Create an organization

POST/organizations/{organizationId}

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/7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1" \  -H "Content-Type: application/json" \  -d '{    "slug": "acme",    "name": "Acme",    "status": "active",    "onboardedAt": "2026-01-01T00:00:00.000Z",    "rootUri": "memory://organizations/acme",    "authorizationEpoch": 1,    "config": {      "timezone": "UTC",      "departments": {        "growth": {          "enabled": true        },        "engineering": {          "enabled": true        },        "support": {          "enabled": true        }      },      "limits": {        "maxConcurrentRuns": 3,        "maxDailyActions": 100,        "maxTaskDepth": 4,        "maxPlanOperations": 25,        "maxInitiativeDescendants": 100      },      "storageRootUri": "memory://organizations/acme"    },    "constraints": {      "allowedIntegrations": [],      "blockedDomains": [],      "approvalRequiredForRisk": [        "external",        "high"      ]    }  }'

{  "success": true,  "statusCode": 201,  "message": "Organization created.",  "data": {    "id": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "slug": "acme",    "name": "Acme",    "status": "active",    "onboardedAt": "2026-01-01T00:00:00.000Z",    "rootUri": "memory://organizations/acme",    "authorizationEpoch": 1,    "config": {      "timezone": "UTC",      "departments": {        "growth": {          "enabled": true        },        "engineering": {          "enabled": true        },        "support": {          "enabled": true        }      },      "limits": {        "maxConcurrentRuns": 3,        "maxDailyActions": 100,        "maxTaskDepth": 4,        "maxPlanOperations": 25,        "maxInitiativeDescendants": 100      },      "storageRootUri": "memory://organizations/acme"    },    "constraints": {      "allowedIntegrations": [],      "blockedDomains": [],      "approvalRequiredForRisk": [        "external",        "high"      ]    },    "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",    "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",    "requestId": "4bf92f3577b34da6a3ce929d0e0e4736"  }}

Update an organization

PATCH/organizations/{organizationId}

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 PATCH "https://example.com/organizations/7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1" \  -H "Content-Type: application/json" \  -d '{    "name": "Acme Global"  }'

{  "success": true,  "statusCode": 200,  "message": "Organization updated.",  "data": {    "id": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "slug": "acme",    "name": "Acme Global",    "status": "active",    "onboardedAt": "2026-01-01T00:00:00.000Z",    "rootUri": "memory://organizations/acme",    "authorizationEpoch": 1,    "config": {      "timezone": "UTC",      "departments": {        "growth": {          "enabled": true        },        "engineering": {          "enabled": true        },        "support": {          "enabled": true        }      },      "limits": {        "maxConcurrentRuns": 3,        "maxDailyActions": 100,        "maxTaskDepth": 4,        "maxPlanOperations": 25,        "maxInitiativeDescendants": 100      },      "storageRootUri": "memory://organizations/acme"    },    "constraints": {      "allowedIntegrations": [],      "blockedDomains": [],      "approvalRequiredForRisk": [        "external",        "high"      ]    },    "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",    "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",    "requestId": "4bf92f3577b34da6a3ce929d0e0e4736"  }}

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

Delete an organization

DELETE/organizations/{organizationId}

Path Parameters

organizationId*string

Organization identifier.

Formatuuid

Response Body

`application/json`

curl -X DELETE "https://example.com/organizations/7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1"

{  "success": true,  "statusCode": 200,  "message": "Organization deleted.",  "data": {    "id": "7d4a6f1d-ff64-4a4f-9e8d-937bfaa0d2f1",    "slug": "acme",    "name": "Acme",    "status": "active",    "onboardedAt": "2026-01-01T00:00:00.000Z",    "rootUri": "memory://organizations/acme",    "authorizationEpoch": 1,    "config": {      "timezone": "UTC",      "departments": {        "growth": {          "enabled": true        },        "engineering": {          "enabled": true        },        "support": {          "enabled": true        }      },      "limits": {        "maxConcurrentRuns": 3,        "maxDailyActions": 100,        "maxTaskDepth": 4,        "maxPlanOperations": 25,        "maxInitiativeDescendants": 100      },      "storageRootUri": "memory://organizations/acme"    },    "constraints": {      "allowedIntegrations": [],      "blockedDomains": [],      "approvalRequiredForRisk": [        "external",        "high"      ]    },    "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",    "traceId": "4bf92f3577b34da6a3ce929d0e0e4736",    "requestId": "4bf92f3577b34da6a3ce929d0e0e4736"  }}

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

200application/json

400application/json

200application/json

400application/json

404application/json

201application/json

400application/json

200application/json

400application/json

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