# Builds (/api/reference/builds)



A build is one run of a pipeline. Each build has a `number` unique within
its pipeline (the URL key) and a stable `id` UUID. Its aggregate state —
`scheduled`, `running`, `passed`, `failed`, `canceled`, `skipped` — rolls
up from the states of its jobs.

These endpoints trigger a build, read it, cancel a running one, list its
artifacts, and mint the short-lived token the browser uses to stream live
logs. The jobs that make up a build live under [Jobs](/api/reference/jobs).

{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

<APIPage document="&#x22;./openapi.json&#x22;" webhooks="[]" operations="[{&#x22;path&#x22;:&#x22;/api/v0/organizations/{org}/builds&#x22;,&#x22;method&#x22;:&#x22;post&#x22;},{&#x22;path&#x22;:&#x22;/api/v0/organizations/{org}/pipelines/{pipeline}/builds&#x22;,&#x22;method&#x22;:&#x22;get&#x22;},{&#x22;path&#x22;:&#x22;/api/v0/organizations/{org}/pipelines/{pipeline}/builds&#x22;,&#x22;method&#x22;:&#x22;post&#x22;},{&#x22;path&#x22;:&#x22;/api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}&#x22;,&#x22;method&#x22;:&#x22;get&#x22;},{&#x22;path&#x22;:&#x22;/api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}/cancel&#x22;,&#x22;method&#x22;:&#x22;put&#x22;},{&#x22;path&#x22;:&#x22;/api/v0/organizations/{org}/pipelines/{pipeline}/builds/{number}/log-token&#x22;,&#x22;method&#x22;:&#x22;get&#x22;}]" />