Files
dashback/docs/api/routes/auth/selected-company.md
2026-09-30 19:29:13 +02:00

47 lines
796 B
Markdown

# `PUT /auth/selected-company`
Protected. Requires a valid session cookie (`credentials: 'include'`).
Set selected company
Sets the authenticated user's selected company.
## Body (JSON)
| Field | Required | Type | Description |
|-------|----------|------|-------------|
| `companyId` | yes | integer | |
```json
{
"companyId": 1
}
```
## Response `200`
Updated user
```json
{
"user": {
"id": 1,
"email": "user@example.com",
"selectedCompanyId": 1,
"picture": "…"
}
}
```
## Errors
| Status | Description |
|--------|-------------|
| 400 | Invalid companyId — `{"error":"…"}` |
| 401 | Unauthorized — `{"error":"…"}` |
| 500 | Server error — `{"error":"…"}` |
---
_Generated from `@openapi` JSDoc. Do not edit by hand — run `npm run docs:api`._