API reference
/- Delete a venue
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
Delete 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
List location types
Create a location type
Read a location type
Update a location type
Delete a location type
Delete a venue
Removes the venue. The record is retained internally so past reporting is not lost, but the venue can no longer be read or edited and no endpoint restores it.
A venue with roles still recruiting at it cannot be deleted - remove or reassign those roles first. The same applies to the account's built-in default venue, which is not removable at all.
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/location/{location_id}/venue/{id}
- Your Rosterfy accounthttps://example.rosterfy.com/api/v2/headcount/location/{location_id}/venue/{id}
curl -i -X DELETE \
'https://developer.rosterfy.com/_mock/api-docs/openapi/api/v2/headcount/location/{location_id}/venue/{id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Rosterfy-Platform: admin'