---
title: "Open Support Session"
method: POST
path: "/admin/support-sessions"
tags: ["admin-support-sessions"]
---

# Open Support Session

`POST /admin/support-sessions`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/admin/support-sessions`
- Auth: none declared

Enter one customer's tenant as support, with a stated reason (admin).

Returns a session id to send as ``X-Support-Session`` on subsequent requests. While
it is set the caller is scoped to this one company and is **read-only** until an
explicit unlock. The session expires on its own, and opening one is recorded in the
admin audit trail before it takes effect.

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- SupportSessionOpen: Enter one customer's tenant, with a stated reason.
  - `company_id` string, required
  - `reason` string, required

## Response `201`

Successful Response

- SupportSessionOut
  - `id` string, required
  - `company_id` string, required
  - `reason` string, required
  - `opened_at` string, date-time, required
  - `expires_at` string, date-time, required
  - `write_unlocked_until` string, date-time, nullable, required
  - `closed_at` string, date-time, nullable, required
  - `may_write` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)