Skip to content
Docs

Add a responsibility

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

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.

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.

Request Body

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

Response Body

The responsibility.

Example Request
curl -X POST 'https://app.useroster.work/api/workspaces/string/hires/string/responsibilities' \  -H 'Content-Type: application/json' \  -d '{  "title": "string",  "schedule": {    "kind": "once",    "at": "2019-08-24T14:15:22Z"  }}'
Example Response
Empty