Change a department

PATCH

/api/workspaces/{ws}/departments/{id}

PATCH

/api/workspaces/{ws}/departments/{id}

Only the fields given change; null clears parentId, channel, monthlyHours or maxAgentTurns.

Authorization

session

cookiebetter-auth.session_token<token>

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

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.

application/json

name?string

Length1 <= length <= 80

mission?string

Lengthlength <= 2000

Default""

parentId?|

Defaultnull

channel?|

Defaultnull

monthlyHours?|

Defaultnull

maxAgentTurns?|

Defaultnull

The department.

Example Request

curl -X PATCH 'https://app.useroster.work/api/workspaces/string/departments/string' \
  -H 'Content-Type: application/json' \
  -d '{}'

Example Request

curl -X PATCH 'https://app.useroster.work/api/workspaces/string/departments/string' \  -H 'Content-Type: application/json' \  -d '{}'

Example Response

Empty