Get Blueprint Runs

get/v1/blueprint-runs/{blueprint_run_id}

Returns a single blueprint analyzer run by id, including its final status, result blueprint, and any error context. Read only, no side effects. Scoped to the authenticated workspace.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
blueprint_run_id	string <uuid>	Yes	UUID of the blueprint run.e.g. 0e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b

Request

cURL

curl -X GET https://api.wellapp.ai/v1/blueprint-runs/{blueprint_run_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The blueprint run.

{
  "data": {
    "type": "blueprint_run",
    "id": "0e1f2a3b-4c5d-4e6f-8a9b-0c1d2e3f4a5b",
    "attributes": {
      "goal": "Build a Mercury statement export blueprint for Foldspace AI",
      "status": "failed",
      "step_count": 6,
      "failed_at_step": 6,
      "error_type": "navigation_timeout",
      "error_message": "Login page did not settle within 30s.",
      "error_context": {
        "page_url": "https://mercury.com/login"
      },
      "result_blueprint": null,
      "firebase_uid": "remy-okafor-uid",
      "completed_at": null,
      "created_at": "2026-06-07T13:32:02.000Z",
      "updated_at": "2026-06-07T13:34:50.000Z"
    },
    "relationships": {
      "steps": {
        "data": [
          {
            "type": "blueprint_step",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        ]
      }
    }
  }
}

401 — Missing or invalid bearer token.

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — No blueprint run exists with the supplied id.

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}