Artifacts endpoint

Start Artifact Build Run

POST/artifact-builds/{buildId}/runs/

Path parameters

buildId

Identifier used by the registered route.

Request body

none

This endpoint does not accept a request body.

cURL template

curl --fail-with-body \
  -H "Authorization: Bearer ${AKOFLOW_API_TOKEN}" \
  -X POST \
  "${AKOFLOW_API_URL}/artifact-builds/{buildId}/runs/"

Replace the path identifiers with IDs from your instance.

202 Acceptedapplication/json

Field shape inferred from Go types; inspect the returned JSON for actual values and optional fields.

{
  "id": "string",
  "artifactBuildId": "string",
  "status": "string",
  "outputVariantId": "string",
  "outputDigest": "string",
  "logs": "string",
  "error": "string"
}

Handler-checked behavior

buildId must identify an existing build specification. This request starts a build run and returns its record with 202 Accepted; inspect GET /build-runs/{runId}/ for its outcome. The request has no JSON body.

Related guide

See the Artifacts guide for related tasks and context.