This contract, served by the running instance (password-protected)
The embedded copy of this OpenAPI document — backs the reference UI above and is handy for local codegen against a running instance. Same Basic Auth gate as /docs.
View as MarkdownAuthorization
docsBasic Gates /docs and /docs/openapi.yaml only. Credentials come from the DOCS_USER/DOCS_PASSWORD env vars; if either is unset the routes are not registered at all (404), never served open.
In: header
Response Body
text/plain
curl -X GET "https://example.com/docs/openapi.yaml""string"API reference UI (password-protected)
Scalar API reference for the running instance, gated by HTTP Basic Auth (DOCS_USER/DOCS_PASSWORD) — not linked from any product surface. The route is only registered at all when both env vars are set; an unconfigured deployment 404s here instead of serving it open.
List the workspace's members
People in the caller's active workspace, ordered by name then email — the source for assignee and lead pickers. Replicated from the platform event stream, so it lists EVERY member of the workspace, including people who have never opened Tasks. It used to be built from JWTs as they arrived, which meant a colleague who had not signed in here could not be assigned an issue. `team` narrows the list to one team's members, which is what an issue's assignee picker passes: an issue belongs to a team, so its candidate assignees are that team's people. A team the caller cannot reach returns an empty list rather than an error. Omit it for workspace-level surfaces. `q` narrows by a case-insensitive name/email match and caps the result at 20 — the @mention suggestion dropdown (EAS-92), which would otherwise ship a large workspace's entire roster on every keystroke. The unfiltered and team-filtered forms stay uncapped.