Get a job
GET/jobs/:job_id
Returns one job: its description, how it is worked, what it pays, how many people have applied, and the workflow it runs through.
Job data and workflow data are separate. A job names its workflow by ID and name, and the rounds are read with Get a workflow. How many applications are in each stage is read with Get a job's counts, because that is the one read that scans a job's history.
The API reads jobs and does not edit them. To change a job, use the Tarkflo dashboard.
The role this key acts as needs the jobs:view permission.
Request
Responses
- 200
- 401
- 403
- 404
- 429
The job.
Response Headers
Requests allowed in the current window for this key.
Requests left in the current window.
The key is missing, malformed, expired or revoked.
The key is valid but may not do this: the role it acts as lacks the permission this call needs (forbidden,
with the permission in required), or the workspace's plan has lapsed (billing_past_due: reads still work,
adding candidates is paused) or is suspended (account_suspended).
There is no job with that ID in your workspace.
Too many requests. Wait for Retry-After seconds, then retry.
Response Headers
Seconds to wait before retrying.