# Organization Sub-Resource Endpoints {#organization-sub-resource-endpoints}


Manage departments, positions, teams, vendors, and organization settings.


## Organization Departments {#organization-departments}



### Base Path: `/api/organization-department` {#base-path-apiorganization-department}


```
GET    /api/organization-department           # List departments
GET    /api/organization-department/:id       # Get by ID
POST   /api/organization-department           # Create
PUT    /api/organization-department/:id       # Update
DELETE /api/organization-department/:id       # Delete
```

**Create Body:**

```json
{
  "name": "Engineering",
  "tags": [{ "id": "tag-uuid" }],
  "members": [{ "id": "employee-uuid" }]
}
```


## Organization Positions {#organization-positions}



### Base Path: `/api/organization-position` {#base-path-apiorganization-position}


```
GET    /api/organization-position             # List positions
GET    /api/organization-position/:id         # Get by ID
POST   /api/organization-position             # Create
PUT    /api/organization-position/:id         # Update
DELETE /api/organization-position/:id         # Delete
```


## Organization Teams {#organization-teams}



### Base Path: `/api/organization-team` {#base-path-apiorganization-team}


```
GET    /api/organization-team                 # List teams
GET    /api/organization-team/:id             # Get by ID
POST   /api/organization-team                 # Create
PUT    /api/organization-team/:id             # Update
DELETE /api/organization-team/:id             # Delete
GET    /api/organization-team/me              # My teams
GET    /api/organization-team/count           # Team count
```

**Create Team Body:**

```json
{
  "name": "Frontend Team",
  "prefix": "FE",
  "members": [{ "id": "employee-uuid", "role": "MANAGER" }],
  "tags": [{ "id": "tag-uuid" }]
}
```


## Organization Vendors {#organization-vendors}



### Base Path: `/api/organization-vendor` {#base-path-apiorganization-vendor}


```
GET    /api/organization-vendor               # List vendors
GET    /api/organization-vendor/:id           # Get by ID
POST   /api/organization-vendor               # Create
PUT    /api/organization-vendor/:id           # Update
DELETE /api/organization-vendor/:id           # Delete
```


## Organization Languages {#organization-languages}



### Base Path: `/api/organization-language` {#base-path-apiorganization-language}


```
GET    /api/organization-language             # List
POST   /api/organization-language             # Add language
DELETE /api/organization-language/:id         # Remove language
```


## Organization Settings {#organization-settings}



### Base Path: `/api/organization-setting` {#base-path-apiorganization-setting}


```
GET    /api/organization-setting              # Get settings
POST   /api/organization-setting              # Create
PUT    /api/organization-setting/:id          # Update
```


## Organization Recurring Expense {#organization-recurring-expense}



### Base Path: `/api/organization-recurring-expense` {#base-path-apiorganization-recurring-expense}


```
GET    /api/organization-recurring-expense             # List
GET    /api/organization-recurring-expense/:id         # Get by ID
POST   /api/organization-recurring-expense             # Create
PUT    /api/organization-recurring-expense/:id         # Update
DELETE /api/organization-recurring-expense/:id         # Delete
GET    /api/organization-recurring-expense/start-date  # By date
```


## Permissions {#permissions}


| Resource   | View Permission       | Edit Permission       |
| ---------- | --------------------- | --------------------- |
| Department | `ORG_DEPARTMENT_VIEW` | `ORG_DEPARTMENT_EDIT` |
| Position   | —                     | `ORG_EMPLOYEES_EDIT`  |
| Team       | `ORG_TEAM_VIEW`       | `ORG_TEAM_EDIT`       |
| Vendor     | `ORG_VENDORS_VIEW`    | `ORG_VENDORS_EDIT`    |


## Related Pages {#related-pages}


- [Organization Endpoints](https://sourcey-gauzy.pages.dev/api/organization-endpoints/index.md) — main org API
- [Departments & Positions](https://sourcey-gauzy.pages.dev/features/departments-and-positions/index.md) — feature guide
- [Teams](https://sourcey-gauzy.pages.dev/features/organization-teams/index.md) — team management