> For the complete documentation index, see [llms.txt](https://qbits-organization.gitbook.io/buildwise-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://qbits-organization.gitbook.io/buildwise-doc/organisation.md).

# Organisation

## Organisation Management API

Complete API endpoints for managing organisations in the BuildWise platform. All organisations are associated with authenticated and authorized user accounts.

### Base URL

```
/api/v1/organisation
```

### Authentication

All endpoints require JWT Bearer token authentication:

```
Authorization: Bearer <access-token>
```

### Standard Response Format

All API responses follow this consistent structure:

```json
{
  "success": boolean,
  "httpStatus": "HTTP_STATUS_CODE",
  "message": "Descriptive message",
  "action_time": "ISO-8601 timestamp",
  "data": {} // Response payload or error details
}
```

***

### Response Format

All API responses follow this consistent structure:

```json
{
  "success": boolean,
  "httpStatus": "HTTP_STATUS_CODE",
  "message": "Descriptive message",
  "action_time": "ISO-8601 timestamp",
  "data": {} // Response payload or error details
}
```

### Common Error Codes

* `200` - Success
* `400` - Bad Request (validation errors, duplicate names)
* `401` - Unauthorized (invalid or missing token)
* `404` - Not Found (organisation or user not found)
* `422` - Unprocessable Entity (validation failures)
* `500` - Internal Server Error

### Organisation Response Schema

```json
{
  "organisationId": "string (UUID)",
  "organisationName": "string",
  "ownerId": "string (UUID)",
  "ownerUserName": "string",
  "description": "string",
  "active": "boolean",
  "deleted": "boolean",
  "createdAt": "string (ISO-8601)",
  "updatedAt": "string (ISO-8601)"
}
```