Skip to content
Docs

Change a responsibility

PATCH
/api/workspaces/{ws}/hires/{id}/responsibilities/{rid}

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.

rid*string

The responsibility's id.

Request Body

application/json
  1. body
conversation?|null
title?string
Length1 <= length <= 120
instructions?string
Lengthlength <= 4000
schedule?|||
enabled?boolean

Response Body

The responsibility.

Example Request
curl -X PATCH 'https://app.useroster.work/api/workspaces/string/hires/string/responsibilities/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty

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.

Remove a responsibility DELETE

Next Page