Organizations

Manage your organization settings. Create, list, get, update, and delete organizations.

Manage your organization settings.

Organizations

List Organizations

GET/organisations

List all organizations the current user belongs to.

Create Organization

POST/organisations

Create a new organization.

Request · bash

curl -X POST https://api.zop.dev/organisations \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
  "name": "Acme Corp"
}'

Response · json

{
"data": {
  "id": "3f6c2a9e-8b1d-4c7e-9f2a-1d5e6b7c8a90",
  "name": "Acme Corp",
  "createdBy": "founder@acme.com",
  "createdAt": "2025-01-05T08:00:00Z",
  "updatedAt": "2025-01-05T08:00:00Z"
}
}

Get Current Organization

GET/organisation

Get details of the currently selected organization.

Update Organization

PUT/organisation

Update the current organization's name or settings.

Delete Organization

DELETE/organisation

Delete the current organization. This removes all associated data including users, teams, and resources.

Audit Logs

Audit logs for the organization are documented on the Audit Logs page, including the filter parameters, the entry format and CSV export.

Organization Object

Field	Type	Description
`id`	string	Unique organization ID (UUID)
`name`	string	Organization display name
`createdBy`	string	Email of the creator
`createdAt`	string	ISO 8601 creation timestamp
`updatedAt`	string	ISO 8601 last update timestamp