# Platform API for Jobs

> Follow a job you started, read its result, or cancel it.

Follow a job you started, read its result, or cancel it.

## Available operations

- [List jobs](https://docs.refabric.com/api-reference/platform/jobs/list-jobs) — `GET /v1/jobs`: Your jobs, newest first — every job of the account, whichever key or the app started it; each row names the key that started it.
- [Read a job](https://docs.refabric.com/api-reference/platform/jobs/read-a-job) — `GET /v1/jobs/{job_id}`: Where one job is: `lifecycle`, `outcome` (`null` until it ends), `progress`, and the `error` of a job that failed — cheap enough to poll.
- [Read a job's result](https://docs.refabric.com/api-reference/platform/jobs/read-a-jobs-result) — `GET /v1/jobs/{job_id}/result`: What a succeeded job delivered: its files, one page at a time, and a summary.
- [Cancel a job](https://docs.refabric.com/api-reference/platform/jobs/cancel-a-job) — `PUT /v1/jobs/{job_id}/cancel`: `202` with the job's `lifecycle` now — the request to stop was accepted; the job read says how it ended.