Skip to content
Docs

List responsibilities

GET
/api/workspaces/{ws}/hires/{id}/responsibilities

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).

id*string

The id of what the path names: a hire, a connection, a skill, a shared file, a department, a position, a goal or an approval.

Response Body

The hire's responsibilities, with when each runs next.

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

Close or reopen a work item PATCH

Previous Page

Add a responsibility POST

`schedule` supports `{kind:"once", at:"2026-11-11T14:00:00+04:00"}`, `{kind:"weekly", days:[1,2,3,4,5], time:"09:00", timezone:"Asia/Dubai"}`, `{kind:"every", hours:4}` and `{kind:"watch", connectionId, everyMinutes:30}`. Weekly timezone defaults to the hire timezone. Once and weekly schedules run outside working hours; intervals and watches respect them. Optional `conversation: {adapter, channelId, threadId}` delivers to a chat connected to this hire; null uses its home. One-time schedules require a future timestamp with offset and turn off atomically when queued. Paused hires retain pending one-time work. Execution starts on a scheduler tick (about 15s), subject to queue capacity, access, approvals and budgets.