API reference
/- Delete a job title
List functional areas
Create a functional area
Read a functional area
Update a functional area
Delete a functional area
List job titles
Create a job title
Read a job title
Update a job title
List functional area types
Create a functional area type
Read a functional area type
Update a functional area type
Delete a functional area type
Add people to a functional area
List locations
Create a location
Read a location
Update a location
Delete a location
List a location's venues
Create a venue
Read a venue
Update a venue
Delete a venue
List location types
Create a location type
Read a location type
Update a location type
Delete a location type
Delete a job title
Removes the role. The record is retained internally so past reporting is not lost, but the role can no longer be read or edited and no endpoint restores it.
A role that is still recruiting cannot be deleted - close or reassign its recruitment first.
Returns 200 with a messages field rather than an empty 204. messages carries anything the platform wants to tell you about the deletion and is null when there is nothing to say.
Security
default
- Mock serverhttps://developer.rosterfy.com/_mock/api-docs/openapi/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}
- Your Rosterfy accounthttps://example.rosterfy.com/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}
curl -i -X DELETE \
'https://developer.rosterfy.com/_mock/api-docs/openapi/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Rosterfy-Platform: admin'