Skip to content
Docs

The org chart

GET
/api/workspaces/{ws}/org

Every department and position, each with hoursUsed: hours on shift this calendar month (UTC), as timecards measure them. A position's holder is { kind: "hire", hireId, displayName, role }, { kind: "person", userId, name, chat } or { kind: "open" }.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

ws*string

The workspace id (from GET /api/me).

Response Body

{ departments, positions }.

Example Request
curl -X GET 'https://app.useroster.work/api/workspaces/string/org'
Example Response
Empty

A signed link GET

Opens a shared file without signing in while `exp` hasn't passed. Links come from the API above.

Add a department POST

`monthlyHours` null means no limit. A name is unique in the workspace; a parent can't be the department itself or inside it.