Xeonr Developer Docs

ListPipelineRuns

POST
/uplim.api.v1.PipelineAdminService/ListPipelineRuns

-------- Pipeline run observation --------

AuthorizationBearer <token>

JWT access token obtained via OAuth2 flow or service account

In: header

Header Parameters

Connect-Protocol-Version*number

Define the version of the Connect protocol

Value in1
Connect-Timeout-Ms?number

Define the timeout, in ms

Request Body

application/json

integrationId?string
Formatuuid
statuses?statuses

Optional filters — all applied as AND.

triggers?triggers
bucketId?string|null
enqueuedBefore?google.protobuf.Timestamp|null
enqueuedAfter?google.protobuf.Timestamp|null
contentTypeUrn?string|null

Filter to runs whose pipeline targets this content-type URN. Resolved against the pipeline (not the run) so a run is included regardless of which snapshot version it executed against.

pipelineVersion?integer|null

Filter to runs of pipelines pinned to this exact published version. Most useful as "show me only runs of v3" when triaging a fresh publish; pair with content_type_urn for a single pipeline's run history.

uploadId?string|null

Filter to runs bound to this specific upload id (Upload kind + VirtualFileSentinel kind both surface the upload's UUID here).

pageToken?string

Cursor: previous page's last run's enqueued_at, RFC3339Nano.

limit?integer

Default 50, max 200.

[key: string]?never

Response Body

application/json

application/json

curl -X POST "https://uploads-api.xeonr.io/uplim.api.v1.PipelineAdminService/ListPipelineRuns" \  -H "Connect-Protocol-Version: 1" \  -H "Content-Type: application/json" \  -d '{}'
{
  "runs": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "snapshotId": "09520abc-01e6-4da1-8fa5-f10e3883c861",
      "integrationId": "497a18ca-284e-40c0-985d-f72be35d468e",
      "bucketId": "string",
      "trigger": "PIPELINE_RUN_TRIGGER_UNSPECIFIED",
      "resource": {
        "kind": "PIPELINE_RESOURCE_KIND_UNSPECIFIED",
        "folderId": "string"
      },
      "batchId": "string",
      "status": "PIPELINE_RUN_STATUS_UNSPECIFIED",
      "failureClass": "STEP_FAILURE_CLASS_UNSPECIFIED",
      "failureStepId": "string",
      "failureMessage": "string",
      "stepRuns": [
        {
          "stepId": "string",
          "parentStepId": "string",
          "status": "STEP_RUN_STATUS_UNSPECIFIED",
          "attempt": 0,
          "failureClass": "STEP_FAILURE_CLASS_UNSPECIFIED",
          "failureMessage": "string",
          "resolvedInputsJson": "string",
          "blobOutputNames": [
            "string"
          ],
          "kvOutputKeys": [
            "string"
          ],
          "localOutputNames": [
            "string"
          ],
          "localBlobNames": [
            "string"
          ],
          "logsObjectKey": "string",
          "logsTruncated": true,
          "utilisation": {
            "cpuMilliseconds": 0,
            "wallTimeMs": 0,
            "blobBytesWritten": 0,
            "kvWrites": 0,
            "httpCallsOutbound": 0,
            "peakMemoryBytes": 0
          },
          "startedAt": "2023-01-15T01:30:15.01Z",
          "finishedAt": "2023-01-15T01:30:15.01Z"
        }
      ],
      "supersededByRunId": "458849c9-1a7a-4314-b11d-cb996f79bcdf",
      "pipelineUrn": "string",
      "enqueuedAt": "2023-01-15T01:30:15.01Z",
      "startedAt": "2023-01-15T01:30:15.01Z",
      "finishedAt": "2023-01-15T01:30:15.01Z",
      "traceRunId": "string"
    }
  ],
  "nextPageToken": "string"
}
{
  "code": "not_found",
  "message": "string",
  "details": [
    {
      "type": "string",
      "value": "string",
      "debug": {}
    }
  ]
}