> ## Documentation Index > Fetch the complete documentation index at: https://docs.watchdog.no/llms.txt > Use this file to discover all available pages before exploring further. # List workflow runs > Lists visible product executions, newest first (created_at, then UUID). Filters are combined with AND; comma-separated values within a filter use OR. Reads include only the shipped public workflow inventory within the requested organization. Follow next_cursor until null. Use status=queued,running to discover active work; poll known ids without a status filter to observe completion. Explicit retries appear as separate runs. Reads do not contact the execution provider. ## OpenAPI ````yaml /openapi-preview.json get /v1/workflow-runs openapi: 3.1.0 info: title: Watchdog API (preview) version: 1.0.0 description: >- Development preview for agreements, price items, document relationships, canonical invoices, alerts and alert topics, claims and attached alerts, shared entity activity and comments, Document uploads, invoice imports, explicit invoice-agreement matching, and workflow runs. This contract is under development and is not served by api.watchdog.no. Request bodies are limited to 2 MiB (2,097,152 bytes), including all JSON fields and line data, except POST /v1/support/contact which permits 32 MiB for base64 attachments. File bytes are uploaded directly to storage. The existing public REST service retains its separate contract. servers: - url: http://localhost:3500 description: Local development Worker security: [] paths: /v1/workflow-runs: get: tags: - Workflow runs summary: List workflow runs description: >- Lists visible product executions, newest first (created_at, then UUID). Filters are combined with AND; comma-separated values within a filter use OR. Reads include only the shipped public workflow inventory within the requested organization. Follow next_cursor until null. Use status=queued,running to discover active work; poll known ids without a status filter to observe completion. Explicit retries appear as separate runs. Reads do not contact the execution provider. operationId: listWorkflowRuns parameters: - name: X-Organization-Id in: header required: false schema: type: string description: >- Required for personal API keys. Target one organization you have access to. Migrated keys may omit it to use their original organization. For Clerk sessions, it must match the active organization. - schema: type: integer minimum: 1 maximum: 100 default: 50 description: Maximum number of results per page. required: false description: Maximum number of results per page. name: limit in: query - schema: type: string maxLength: 4096 description: >- Opaque next_cursor from the previous page. Keep the same filters and sort; omit for the first page. required: false description: >- Opaque next_cursor from the previous page. Keep the same filters and sort; omit for the first page. name: cursor in: query - schema: type: string maxLength: 4000 description: >- Comma-separated statuses. Omit to include all statuses, including terminal runs. required: false description: >- Comma-separated statuses. Omit to include all statuses, including terminal runs. name: status in: query - schema: type: string maxLength: 4000 description: Comma-separated public workflow types. required: false description: Comma-separated public workflow types. name: type in: query - schema: type: string maxLength: 27 format: date-time description: >- Inclusive creation time, as a UTC timestamp with at most six fractional digits. required: false description: >- Inclusive creation time, as a UTC timestamp with at most six fractional digits. name: created_from in: query - schema: type: string maxLength: 27 format: date-time description: >- Exclusive creation time, as a UTC timestamp with at most six fractional digits. required: false description: >- Exclusive creation time, as a UTC timestamp with at most six fractional digits. name: created_before in: query - schema: type: string enum: - invoice_import - workflow_run - invoice - agreement - document - integration - agreement_price_import required: false name: resource_type in: query - schema: type: string format: uuid description: Owner ID; requires resource_type. required: false description: Owner ID; requires resource_type. name: resource_id in: query - schema: type: string maxLength: 4000 description: >- Optional comma-separated run IDs, at most 100. Unknown or inaccessible IDs are omitted. required: false description: >- Optional comma-separated run IDs, at most 100. Unknown or inaccessible IDs are omitted. name: ids in: query responses: '200': description: A page of visible runs. next_cursor is null at the end. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/WorkflowRun' maxItems: 100 next_cursor: type: - string - 'null' required: - data - next_cursor example: data: - id: 44444444-4444-4444-8444-444444444444 retry_of_run_id: null type: invoice_import resource: type: invoice_import id: 33333333-3333-4333-8333-333333333333 status: completed progress: total: 1 queued: 0 running: 0 completed: 1 skipped: 0 failed: 0 cancelled: 0 created_at: '2026-09-08T12:00:00.000Z' updated_at: '2026-09-08T12:00:30.000Z' started_at: '2026-09-08T12:00:02.000Z' finished_at: '2026-09-08T12:00:30.000Z' failure: null next_cursor: null '400': description: >- Invalid request format, parameters, or body. Details contain up to 20 actionable field errors; the complete encoded request body must be at most 2 MiB (2,097,152 bytes). headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: '#/components/schemas/Error_validation_error' example: error: code: validation_error message: >- Invalid request format, parameters, or body. Details contain up to 20 actionable field errors; the complete encoded request body must be at most 2 MiB (2,097,152 bytes). request_id: req_example '401': description: Missing or invalid bearer credential. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. WWW-Authenticate: schema: type: string required: false description: Bearer authentication challenge, when supplied. content: application/json: schema: $ref: '#/components/schemas/Error_invalid_token' example: error: code: invalid_token message: Missing or invalid bearer credential. request_id: req_example '403': description: >- Access denied: forbidden, token_disabled, organization_required, insufficient_role, or mfa_required. Check the error code and effective permissions. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: >- #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required example: error: code: forbidden message: >- Access denied: forbidden, token_disabled, organization_required, insufficient_role, or mfa_required. Check the error code and effective permissions. request_id: req_example '429': description: The IP or authenticated credential exceeded its request limit. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. Retry-After: schema: type: string example: '60' required: true description: Seconds to wait before retrying the request. content: application/json: schema: $ref: '#/components/schemas/Error_rate_limit_exceeded' example: error: code: rate_limit_exceeded message: >- The IP or authenticated credential exceeded its request limit. request_id: req_example '500': description: >- Unexpected server failure. Include the request ID when contacting support. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. content: application/json: schema: $ref: '#/components/schemas/Error_internal_error' example: error: code: internal_error message: >- Unexpected server failure. Include the request ID when contacting support. request_id: req_example '503': description: >- Authentication infrastructure is unavailable or rate limited. Honor Retry-After when provided. headers: X-Request-Id: schema: type: string required: true description: >- Request identifier for support and diagnostics; also included in error bodies. Cache-Control: schema: type: string enum: - private, no-store required: false description: >- Organization-scoped API responses must not be cached. May be absent for requests rejected before routing. X-RateLimit-Limit: schema: type: string example: '120' required: false description: >- Requests per minute for the applicable limiter, when evaluated. Authenticated requests use the credential limit; an IP rejection uses the IP limit. Retry-After: schema: type: string example: '60' required: true description: Seconds to wait before retrying the request. content: application/json: schema: $ref: '#/components/schemas/Error_service_unavailable' example: error: code: service_unavailable message: >- Authentication infrastructure is unavailable or rate limited. Honor Retry-After when provided. request_id: req_example security: - ApiKeyBearer: [] - ClerkSessionBearer: [] components: schemas: WorkflowRun: type: object properties: id: type: string format: uuid description: >- One operation containing zero or more work items. Explicit retry creates a new run. retry_of_run_id: type: - string - 'null' format: uuid type: type: string enum: - organization_currency_conversion - document_extraction - agreement_document_classification - agreement_detail_suggestions - invoice_import - invoice_import_batch - invoice_agreement_matching - agreement_invoice_matching - invoice_compliance_check - agreement_compliance_check - integration_sync - alert_topic_reconciliation - alert_topic_proposal - agreement_context_suggestions - agreement_price_import resource: type: object properties: type: type: string enum: - invoice_import - workflow_run - invoice - agreement - document - integration - agreement_price_import id: type: string format: uuid required: - type - id description: >- The business operation owning this execution; for invoice_import, the InvoiceImport. status: type: string enum: - queued - running - completed - completed_with_errors - failed - cancelled progress: type: object properties: total: type: - integer - 'null' minimum: 0 queued: type: integer minimum: 0 running: type: integer minimum: 0 completed: type: integer minimum: 0 skipped: type: integer minimum: 0 failed: type: integer minimum: 0 cancelled: type: integer minimum: 0 required: - total - queued - running - completed - skipped - failed - cancelled description: >- Counts of admitted items. total is null while more items may be discovered. created_at: type: string format: date-time updated_at: type: string format: date-time description: Last product state change, excluding internal provider checks. started_at: type: - string - 'null' format: date-time finished_at: type: - string - 'null' format: date-time failure: type: - object - 'null' properties: code: type: string minLength: 1 maxLength: 100 message: type: string minLength: 1 maxLength: 2000 required: - code - message required: - id - retry_of_run_id - type - resource - status - progress - created_at - updated_at - started_at - finished_at - failure Error_validation_error: type: object properties: error: type: object properties: code: type: string enum: - validation_error message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_invalid_token: type: object properties: error: type: object properties: code: type: string enum: - invalid_token message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required: type: object properties: error: type: object properties: code: type: string enum: - forbidden - token_disabled - organization_required - insufficient_role - mfa_required message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_rate_limit_exceeded: type: object properties: error: type: object properties: code: type: string enum: - rate_limit_exceeded message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_internal_error: type: object properties: error: type: object properties: code: type: string enum: - internal_error message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error Error_service_unavailable: type: object properties: error: type: object properties: code: type: string enum: - service_unavailable message: type: string request_id: type: string description: type: string details: type: array items: type: object properties: code: type: string field: type: string message: type: string required: - code - field - message maxItems: 20 workflow_run_id: type: string format: uuid import_id: type: string format: uuid existing_party: type: object properties: type: type: string enum: - supplier - recipient id: type: string format: uuid required: - type - id required: - code - message - request_id required: - error securitySchemes: ApiKeyBearer: type: http scheme: bearer description: >- Personal API key. Send X-Organization-Id. The required cumulative level is listed in x-watchdog-permission. ClerkSessionBearer: type: http scheme: bearer description: Clerk session with an active organization. ````