Experience bank
POST /me/experience/employments Session or API key
Record a new place — a job or a project.
An employment carries no claim of its own (only the atoms attached to it do), so nothing about provenance applies here. kind is job or project; a project’s name arrives as name on the wire (legacy company accepted as a fallback), a job’s as company.
Body
kindstring requiredjoborproject.Examplejobcompanystring- The employer (jobs) — or the project name via
name(see description).ExampleAcme rolestring- Your title.Example
Senior Backend Engineer locationstring- Where you worked.
startstring- Start date.Example
2023-02 endstring- End date; omit with
current. currentboolean- Still ongoing.
summarystring- A short description of the role.
linkstring- Outbound URL, for a project.
stackstring[]- Technologies used, printed on the CV’s per-role stack line.
curl -X POST "https://freehire.me/api/v1/me/experience/employments" \
-H "Authorization: Bearer $HIREALL_API_KEY" -H 'Content-Type: application/json' \
-d '{"kind":"job","company":"Acme","role":"Senior Backend Engineer","start":"2023-02","current":true}'{ "data": { "id": "3fa8…", "kind": "job", "company": "Acme", "role": "Senior Backend Engineer", "start": "2023-02", "current": true } }