Skip to content
API reference
/
/
Update a functional area...

Update a functional area type

Request

Updates the fields supplied and returns the type in the same shape as reading it. Only the fields sent are touched, so an empty body is a valid request that changes nothing.

Renaming a type does not affect which functional areas are filed under it.

Security
default
Path
idintegerrequired

The ID of the functional area type.

Headers
Rosterfy-Platformstring
Bodyapplication/json
namestring

The name of the group type. Required. Sending a plain string sets the name for the account's default language; it is returned as a plain string in the language of the request.

sort_orderinteger

Where this type sits when types are listed together. Lower values come first, and types sharing a value keep no guaranteed order between them. Defaults to 0.

curl -i -X PUT \
  'https://developer.rosterfy.com/_mock/api-docs/openapi/api/v2/headcount/functionalarea/type/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'Rosterfy-Platform: admin' \
  -d '{
    "name": "Operations",
    "sort_order": 1
  }'

Responses

Bodyapplication/json
objectobject
niceArray of any
relationsArray of any
permissionsobject
Response
{
  "object": {
    "id": 1,
    "name": "Operations",
    "sort_order": 1,
    "uuid": "f5d2192c-e3b6-4162-8e6c-5bc6f65900e9"
  },
  "nice": [],
  "relations": [],
  "permissions": {
    "read": true,
    "update": true,
    "delete": true
  }
}