Work Experiences API

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

List work experiences on a resume

Get a candidate’s work experiences listed on their resume

GET /candidates/:candidate_id/resume/work_experiences

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": "8d0ec106-2ea1-4905-bcc6-86317085607b",
    "title": "Assistant to the Regional Manager",
    "employer_name": "Dunder Miflin",
    "city": "Scranton",
    "state": "Pennsylvania",
    "start_date": "2010-01-01",
    "end_date": "2012-12-01",
    "duties": "Helping out the world's greatest boss."
  }
]

Get a single work experience

GET /candidates/:candidate_id/resume/work_experiences/:work_experience_id

Response

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "8d0ec106-2ea1-4905-bcc6-86317085607b",
  "title": "Assistant to the Regional Manager",
  "employer_name": "Dunder Miflin",
  "city": "Scranton",
  "state": "Pennsylvania",
  "start_date": "2010-01-01",
  "end_date": "2012-12-01",
  "duties": "Helping out the world's greatest boss."
}

Create an work experience

Create a new work experience.

POST /candidates/:candidate_id/resume/work_experiences

Input

description
Required string
source
Required string
date
Optional string 
{
  "description": "Emmy - Best Actor",
  "source": "Academy of Television Arts and Sciences",
  "date": "2012-09-23"
}

Response

Status: 201 Created
Location: https://tapability.org/api/v1/candidates/eaf3022f-330e-46db-8665-01e0969ff2f7/resume/work_experiences/2894c358-f2d0-4a3f-952f-5afdb8dd81aa
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "8d0ec106-2ea1-4905-bcc6-86317085607b",
  "title": "Assistant to the Regional Manager",
  "employer_name": "Dunder Miflin",
  "city": "Scranton",
  "state": "Pennsylvania",
  "start_date": "2010-01-01",
  "end_date": "2012-12-01",
  "duties": "Helping out the world's greatest boss."
}

Update an work experience

Update the provided work experience.

PATCH /candidates/:candidate_id/resume/work_experiences/:work_experience_id

Input

description
Required string
source
Required string
date
Optional string 
{
  "description": "Emmy - Best Actor",
  "source": "Academy of Television Arts and Sciences",
  "date": "2012-09-23"
}

Response

Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
  "id": "8d0ec106-2ea1-4905-bcc6-86317085607b",
  "title": "Assistant to the Regional Manager",
  "employer_name": "Dunder Miflin",
  "city": "Scranton",
  "state": "Pennsylvania",
  "start_date": "2010-01-01",
  "end_date": "2012-12-01",
  "duties": "Helping out the world's greatest boss."
}

Delete an work experience

Delete the provided work experience.

DELETE /candidates/:candidate_id/resume/work_experiences/:work_experience_id

Response

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