> For the complete documentation index, see [llms.txt](https://docs.adaptria.locaria.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adaptria.locaria.com/internal-api/reference/capacity-management.md).

# 📅 Capacity Management

### Capacity Management

Browse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.

## 📅 List capacity allocations

> Mirrors \`GET /api/project/capacity-management/allocations\`. Internal-only — client API keys → 403.

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityListResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/allocations":{"get":{"summary":"📅 List capacity allocations","description":"Mirrors `GET /api/project/capacity-management/allocations`. Internal-only — client API keys → 403.","tags":["📅 Capacity Management"],"responses":{"200":{"description":"Allocations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityListResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/allocations/{allocationId}

> 📅 Get allocation details by ID

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityDetailResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":{}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/allocations/{allocationId}":{"get":{"summary":"📅 Get allocation details by ID","tags":["📅 Capacity Management"],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"allocationId","in":"path"}],"responses":{"200":{"description":"Allocation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityDetailResponse"}}}},"403":{"description":"Forbidden"},"404":{"description":"Not found"}}}}}}
```

## GET /api/public/v1/capacity-management/user-view

> 📅 Get user capacity view

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityListResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/user-view":{"get":{"summary":"📅 Get user capacity view","tags":["📅 Capacity Management"],"parameters":[{"schema":{"type":"string","description":"Start of the date range (ISO 8601 date)"},"required":true,"description":"Start of the date range (ISO 8601 date)","name":"startDate","in":"query"},{"schema":{"type":"string","description":"End of the date range (ISO 8601 date)"},"required":true,"description":"End of the date range (ISO 8601 date)","name":"endDate","in":"query"}],"responses":{"200":{"description":"User capacity view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityListResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/project-view

> 📅 Get project capacity view

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityListResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/project-view":{"get":{"summary":"📅 Get project capacity view","tags":["📅 Capacity Management"],"parameters":[{"schema":{"type":"string","description":"Start of the date range (ISO 8601 date)"},"required":true,"description":"Start of the date range (ISO 8601 date)","name":"startDate","in":"query"},{"schema":{"type":"string","description":"End of the date range (ISO 8601 date)"},"required":true,"description":"End of the date range (ISO 8601 date)","name":"endDate","in":"query"}],"responses":{"200":{"description":"Project capacity view","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityListResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/user-view/filters

> 📅 Get user capacity view filters

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityFiltersResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":{}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/user-view/filters":{"get":{"summary":"📅 Get user capacity view filters","tags":["📅 Capacity Management"],"responses":{"200":{"description":"Filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityFiltersResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/project-view/filters

> 📅 Get project capacity view filters

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityFiltersResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":{}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/project-view/filters":{"get":{"summary":"📅 Get project capacity view filters","tags":["📅 Capacity Management"],"responses":{"200":{"description":"Filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityFiltersResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/public-holidays

> 📅 List public holidays

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityListResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/public-holidays":{"get":{"summary":"📅 List public holidays","tags":["📅 Capacity Management"],"responses":{"200":{"description":"Public holidays","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityListResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/public-holidays/filters

> 📅 Get public holiday filters

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityFiltersResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":{}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/public-holidays/filters":{"get":{"summary":"📅 Get public holiday filters","tags":["📅 Capacity Management"],"responses":{"200":{"description":"Filters","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityFiltersResponse"}}}},"403":{"description":"Forbidden"}}}}}}
```

## GET /api/public/v1/capacity-management/public-holidays/{holidayId}

> 📅 Get public holiday details

```json
{"openapi":"3.1.0","info":{"title":"Adaptria Public API: Connector","version":"1.0.0"},"tags":[{"name":"📅 Capacity Management","description":"## Capacity Management\n\nBrowse capacity allocations, user/project capacity views, and public holidays. Internal-only — client API keys receive `403`.\n"}],"servers":[{"url":"https://api.adaptria.locaria.com","description":"Production Environment"}],"security":[{"apiKeyAuth":[]}],"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Api-key","description":"## API Key Authentication\n\nStatic API key obtained from the Adaptria Portal or via `POST /api/credentials/api-keys`.\n\n**How to authenticate**:\n1. Generate an API key from the Adaptria Portal (Settings → API Keys) or ask your admin\n2. Include the key in all requests using the `Api-key` header\n\n**Key format**: `lla_live_<32-character-string>`\n\n**No token exchange needed** — the key is used directly in every request. Revoke or rotate keys from the portal."}},"schemas":{"PublicCapacityDetailResponse":{"type":"object","properties":{"success":{"type":"boolean","enum":[true]},"data":{"type":"object","additionalProperties":{}}},"required":["success","data"]}}},"paths":{"/api/public/v1/capacity-management/public-holidays/{holidayId}":{"get":{"summary":"📅 Get public holiday details","tags":["📅 Capacity Management"],"parameters":[{"schema":{"type":"string","format":"uuid"},"required":true,"name":"holidayId","in":"path"}],"responses":{"200":{"description":"Holiday","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicCapacityDetailResponse"}}}},"403":{"description":"Forbidden"},"404":{"description":"Not found"}}}}}}
```