Trainings API
- List trainings on a resume
- Get a single training
- Create an training
- Update an training
- Delete an training
These endpoints are only available to counselors and candidates, candidates can only view/edit items in their own resume
List trainings on a resume
Get a candidate’s trainings listed on their resume
GET /candidates/:candidate_id/resume/trainings
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": "7c44e640-d3fc-4b07-bc38-3e1c4bdf9d0e",
"description": "Microsoft Office Specialist",
"source": "Microsoft",
"date": "2013-01-01"
}
]
Get a single training
GET /candidates/:candidate_id/resume/trainings/:training_id
Response
Status: 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
"id": "7c44e640-d3fc-4b07-bc38-3e1c4bdf9d0e",
"description": "Microsoft Office Specialist",
"source": "Microsoft",
"date": "2013-01-01"
}
Create an training
Create a new training.
POST /candidates/:candidate_id/resume/trainings
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/trainings/2894c358-f2d0-4a3f-952f-5afdb8dd81aa
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
{
"id": "7c44e640-d3fc-4b07-bc38-3e1c4bdf9d0e",
"description": "Microsoft Office Specialist",
"source": "Microsoft",
"date": "2013-01-01"
}
Update an training
Update the provided training.
PATCH /candidates/:candidate_id/resume/trainings/:training_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": "7c44e640-d3fc-4b07-bc38-3e1c4bdf9d0e",
"description": "Microsoft Office Specialist",
"source": "Microsoft",
"date": "2013-01-01"
}
Delete an training
Delete the provided training.
DELETE /candidates/:candidate_id/resume/trainings/:training_id
Response
Status: 204 No Content
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999