Files
dashback/docs/api/routes/auth/selected-company.md
2026-11-02 00:19:19 +01:00

985 B

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
{
  "companyId": 1
}

Signals

On success, emits SSE signals: user, company (see GET /events).

Response 200

Updated user

{
  "user": {
    "id": 1,
    "email": "user@example.com",
    "selectedCompanyId": 1,
    "picture": "…"
  }
}

Errors

Status Description
400 Invalid companyId — {"error":"…"}
401 Unauthorized — {"error":"…"}
403 Not authorized (the user is not a member of this company) — {"error":"…"}
500 Server error — {"error":"…"}

Generated from @openapi JSDoc. Do not edit by hand — run npm run docs:api.