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

# Create Sector

> Creates a new sector.

## Endpoint

`POST https://gateway.orkeia.ai/sectors`

**Authentication**\
Requires header `authorization:  <your_token>`.

## Request Body (JSON)

> The service receives a **wrapper** with the property `sector`.

```json theme={null}
{
  "sector": {
    "name": "HR",
    "description": "Human Resources Department"
  }
}
```

## Example (cURL)

```bash theme={null}
curl -X POST "https://gateway.orkeia.ai/sectors"   -H "authorization:  <your_token>"   -H "Content-Type: application/json"   -d '{
    "sector": {
      "name": "HR",
      "description": "Human Resources Department"
    }
  }'
```

## Responses

### Response - Success

```json response theme={null}
{
  "status": "OK",
  "data": { "id": "SECTOR_123456" }
}
```

### 500 — Server Error

```json theme={null}
{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}
```

### 400 — Client Error

```json theme={null}
{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}
```
