Create a job category
const url = 'https://api2.recruso.co.uk/v1/job-categories';const options = { method: 'POST', headers: {Authorization: '<Authorization>', 'Content-Type': 'application/json'}, body: '{"jobCategoryName":"example","displayInSelfRegistration":true}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api2.recruso.co.uk/v1/job-categories \ --header 'Authorization: <Authorization>' \ --header 'Content-Type: application/json' \ --data '{ "jobCategoryName": "example", "displayInSelfRegistration": true }'Creates a job category for your agency. A job category is a skill a worker can be recorded as having.
The name must not already be in use by another of your agency’s records; a clash returns 400 rather than creating a duplicate.
Returns 201 with the created record.
You only ever see and change your own agency’s records; there is no owner id on the request, and an id belonging to another agency returns 404 rather than 403 so that its existence is never disclosed.
Access. Requires a client-credentials access token. Tokens issued through the interactive user login are rejected.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”object
Whether this job category appears in Recruso’s separate worker self-registration service. Your agency chooses which skills a self-registering worker is offered.
Examplegenerated
{ "jobCategoryName": "example", "displayInSelfRegistration": true}Responses
Section titled “Responses”Created
object
Whether this job category appears in Recruso’s separate worker self-registration service. Your agency chooses which skills a self-registering worker is offered.
Examplegenerated
{ "jobCategoryId": 1, "jobCategoryName": "example", "displayInSelfRegistration": true}Bad Request
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Unauthorized
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Forbidden
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}