Categories API

• List categories on a resume
• Create an category
• Delete an category

These endpoints are only available to counselors and candidates, candidates can only view/edit items in their own resume

When adding a new category, you must supply the name of a valid category, such as “Sales”. For an up-to-date listing on valid category names, see the root Categories API endpoint.

List categories on a resume

Get a candidate’s preferred job categories

GET /candidates/:candidate_id/resume/categories

Response

Status: 200 OK
Link: <https://tapability.org/api/v1/resource?page=2>; rel="next",
      <https://tapability.org/api/v1/resource?page=5>; rel="last"
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

[
  {
    "id": "5f7ba741-e6e0-403e-9247-00e6138c313b",
    "name": "Sales"
  }
]

Create an category

Add a new category.

POST /candidates/:candidate_id/resume/categories

Input

name

Required string

{
  "name": "Sales"
}

Response

Status: 201 Created
Location: https://tapability.org/api/v1/candidates/eaf3022f-330e-46db-8665-01e0969ff2f7/resume/categories/5f7ba741-e6e0-403e-9247-00e6138c313b
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999

{
  "id": "5f7ba741-e6e0-403e-9247-00e6138c313b",
  "name": "Sales"
}

Delete an category

Delete the provided category.

DELETE /candidates/:candidate_id/resume/categories/:category_id

Response

Status: 204 No Content
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999