> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dokstamp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> Manage organizational sub-units (faculties, departments, campuses) within an institution.

# Organizations

Organizations are sub-units of an institution — faculties, departments, schools, or campuses. Courses can optionally be associated with an organization for better classification.

***

## The organization object

```json theme={null}
{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "School of Engineering",
  "code": "ENG",
  "institution": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Federal University of Technology"
  },
  "created_at": "2024-01-15T10:00:00.000000Z"
}
```

| Field         | Type   | Description                       |
| ------------- | ------ | --------------------------------- |
| `uuid`        | string | Unique identifier                 |
| `name`        | string | Organization name                 |
| `code`        | string | Short code for internal reference |
| `institution` | object | The parent institution            |

***

## List organizations

```http theme={null}
GET /organizations
```

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.dokstamp.com/organizations \
    -H "Authorization: Bearer {TOKEN}" \
    -H "Accept: application/json" \
    -H "X-Tenant: {TENANT}"
  ```
</CodeGroup>

***

## Create an organization

```http theme={null}
POST /organizations
```

| Parameter          | Type   | Required | Description             |
| ------------------ | ------ | -------- | ----------------------- |
| `name`             | string | Yes      | Organization name       |
| `institution_uuid` | string | Yes      | Parent institution UUID |
| `code`             | string | No       | Short reference code    |

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.dokstamp.com/organizations \
    -H "Authorization: Bearer {TOKEN}" \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "X-Tenant: {TENANT}" \
    -d '{
      "name": "School of Engineering",
      "code": "ENG",
      "institution_uuid": "550e8400-e29b-41d4-a716-446655440000"
    }'
  ```
</CodeGroup>

***

## Get, update, delete

```http theme={null}
GET    /organizations/{uuid}
PATCH  /organizations/{uuid}
PUT    /organizations/{uuid}
DELETE /organizations/{uuid}
DELETE /organizations/batch/destroy
```

All follow the same conventions as other resources. See [Institutions](/en/api-reference/institutions) for detailed examples.