> ## 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. # Get a workflow run item > One work item using the same representation as the collection. An item must belong to the requested run and organization. Pending items have null result and failure. Failed/cancelled items have no result. Completed/skipped items retain their typed business result independently of later invoice edits or explicit retries. Technical execution retries keep the item ID. No provider payloads or task identifiers are exposed. ## OpenAPI ````yaml /openapi-preview.json get /v1/workflow-runs/{id}/items/{item_id} 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/{id}/items/{item_id}: get: tags: - Workflow runs summary: Get a workflow run item description: >- One work item using the same representation as the collection. An item must belong to the requested run and organization. Pending items have null result and failure. Failed/cancelled items have no result. Completed/skipped items retain their typed business result independently of later invoice edits or explicit retries. Technical execution retries keep the item ID. No provider payloads or task identifiers are exposed. operationId: getWorkflowRunItem 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: string format: uuid required: true name: id in: path - schema: type: string format: uuid required: true name: item_id in: path responses: '200': description: >- One work item. Failure is a successful HTTP read with status failed and failure details. 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/WorkflowRunItem' example: id: 66666666-6666-4666-8666-666666666666 run_id: 44444444-4444-4444-8444-444444444444 retry_of_item_id: null resource: type: invoice_import id: 33333333-3333-4333-8333-333333333333 status: completed result: type: invoice_import outcome: imported invoice_id: 55555555-5555-4555-8555-555555555555 failure: null 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' '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 '404': description: The resource does not exist in the current organization. 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_not_found' example: error: code: not_found message: The resource does not exist in the current organization. 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: WorkflowRunItem: type: object properties: id: type: string format: uuid run_id: type: string format: uuid retry_of_item_id: type: - string - 'null' format: uuid resource: anyOf: - 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 - type: object properties: type: type: string enum: - source_invoice id: type: string minLength: 1 required: - type - id description: An invoice in the accounting system, by its provider-owned key. status: type: string enum: - queued - running - completed - skipped - failed - cancelled result: oneOf: - type: object properties: type: type: string enum: - organization_currency_conversion updated: type: integer minimum: 0 missing_rates: type: integer minimum: 0 required: - type - updated - missing_rates - oneOf: - type: object properties: type: type: string enum: - invoice_import outcome: type: string enum: - imported invoice_id: type: string format: uuid required: - type - outcome - invoice_id - type: object properties: type: type: string enum: - invoice_import outcome: type: string enum: - duplicate invoice_id: type: string format: uuid required: - type - outcome - invoice_id - type: object properties: type: type: string enum: - invoice_import outcome: type: string enum: - not_invoice classification_reason: type: - string - 'null' invoice_id: type: 'null' required: - type - outcome - invoice_id - type: object properties: type: type: string enum: - invoice_import_admission outcome: type: string enum: - duplicate - capacity_rejected invoice_id: type: - string - 'null' format: uuid required: - type - outcome - invoice_id - type: object properties: type: type: string enum: - invoice_agreement_matching invoice_id: type: string format: uuid agreement_id: type: - string - 'null' format: uuid matched_count: type: integer minimum: 0 created_count: type: integer minimum: 0 removed_count: type: integer minimum: 0 relationship_ids: type: array items: type: string format: uuid maxItems: 100 relationships_url: type: string required: - type - invoice_id - agreement_id - matched_count - created_count - removed_count - relationship_ids - relationships_url - type: object properties: source_version: type: string strategy: type: string enum: - datalab - deterministic verification: type: object properties: outcome: type: string enum: - verified - skipped - error reason: type: - string - 'null' maxLength: 100 issue_count: type: integer minimum: 0 dropped_correction_count: type: integer minimum: 0 required: - outcome - reason - issue_count - dropped_correction_count type: type: string enum: - document_extraction document_id: type: string format: uuid requested_strategy: type: string enum: - datalab - deterministic fallback_strategy: type: - string - 'null' enum: - datalab - deterministic - null limitations: type: array items: type: string required: - source_version - strategy - verification - type - document_id - requested_strategy - fallback_strategy - limitations - type: object properties: role: type: - string - 'null' enum: - terms - price_list - excluded - null reason: type: string minLength: 1 maxLength: 1000 suggested_import_context: type: - string - 'null' maxLength: 120 type: type: string enum: - agreement_document_classification document_id: type: string format: uuid required: - role - reason - suggested_import_context - type - document_id - type: object properties: type: type: string enum: - agreement_detail_suggestions document_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 10 suggestions: type: object properties: title: type: - string - 'null' minLength: 1 maxLength: 500 effective_date: type: - string - 'null' pattern: ^\d{4}-\d{2}-\d{2}$ expiration_date: type: - string - 'null' pattern: ^\d{4}-\d{2}-\d{2}$ renewal: type: - object - 'null' properties: mode: type: - string - 'null' enum: - none - optional - automatic - null default: null period: type: - object - 'null' properties: value: type: integer exclusiveMinimum: 0 maximum: 2147483647 unit: type: string enum: - days - weeks - months - years default: null required: - value - unit additionalProperties: false occurrences_remaining: type: - integer - 'null' minimum: 0 maximum: 2147483647 default: null notice_period: type: - object - 'null' properties: value: type: integer exclusiveMinimum: 0 maximum: 2147483647 unit: type: string enum: - days - weeks - months - years default: null required: - value - unit additionalProperties: false deadline_override: type: - string - 'null' pattern: ^\d{4}-\d{2}-\d{2}$ default: null additionalProperties: false smart_matching_criterion: type: - string - 'null' minLength: 1 maxLength: 1000 supplier: type: - object - 'null' properties: extracted: type: object properties: name: type: - string - 'null' minLength: 1 maxLength: 500 organization_number: type: - string - 'null' minLength: 1 maxLength: 100 required: - name - organization_number canonical: type: - object - 'null' properties: id: type: string format: uuid name: type: string organization_number: type: - string - 'null' required: - id - name - organization_number required: - extracted - canonical recipient: type: - object - 'null' properties: extracted: type: object properties: name: type: - string - 'null' minLength: 1 maxLength: 500 organization_number: type: - string - 'null' minLength: 1 maxLength: 100 required: - name - organization_number canonical: type: - object - 'null' properties: id: type: string format: uuid name: type: string organization_number: type: - string - 'null' required: - id - name - organization_number required: - extracted - canonical required: - title - effective_date - expiration_date - renewal - smart_matching_criterion - supplier - recipient required: - type - document_ids - suggestions - type: object properties: type: type: string enum: - invoice_compliance_check compliance_check_id: type: string format: uuid invoice_id: type: string format: uuid agreement_id: type: string format: uuid finding_count: type: integer minimum: 0 completeness: type: string enum: - complete - incomplete required: - type - compliance_check_id - invoice_id - agreement_id - finding_count - completeness additionalProperties: false - type: object properties: type: type: string enum: - agreement_compliance_check compliance_check_id: type: string format: uuid invoice_id: type: string format: uuid agreement_id: type: string format: uuid finding_count: type: integer minimum: 0 completeness: type: string enum: - complete - incomplete required: - type - compliance_check_id - invoice_id - agreement_id - finding_count - completeness additionalProperties: false - type: object properties: type: type: string enum: - alert_topic_reconciliation agreement_id: type: string format: uuid topics_created: type: integer minimum: 0 topics_updated: type: integer minimum: 0 topics_deleted: type: integer minimum: 0 memberships_written: type: integer minimum: 0 required: - type - agreement_id - topics_created - topics_updated - topics_deleted - memberships_written additionalProperties: false - type: object properties: type: type: string enum: - alert_topic_proposal proposal_id: type: string format: uuid agreement_id: type: string format: uuid operation: type: string enum: - merge - split required: - type - proposal_id - agreement_id - operation additionalProperties: false - type: object properties: type: type: string enum: - agreement_context_suggestions agreement_id: type: string format: uuid suggestion_ids: type: array items: type: string format: uuid maxItems: 20 description: >- Pending suggestions this dismissal produced, in note order. Empty when the dismissal warranted no edit or its edits no longer applied to the note. required: - type - agreement_id - suggestion_ids additionalProperties: false - type: object properties: type: type: string enum: - agreement_price_import price_import_id: type: string format: uuid counts: type: object properties: created: type: integer minimum: 0 description: Rows appended as new prices. duplicate: type: integer minimum: 0 description: >- Rows with the same product and price as an existing price or an earlier row, and not appended. invalid: type: integer minimum: 0 description: >- Rows that fail the price rules, recorded with their errors and not appended. required: - created - duplicate - invalid required: - type - price_import_id - counts - type: 'null' description: >- Immutable, bounded business result. null until completed or skipped; failed/cancelled items have no result. failure: type: - object - 'null' properties: code: type: string minLength: 1 maxLength: 100 message: type: string minLength: 1 maxLength: 2000 required: - code - message created_at: type: string format: date-time updated_at: type: string format: date-time started_at: type: - string - 'null' format: date-time finished_at: type: - string - 'null' format: date-time required: - id - run_id - retry_of_item_id - resource - status - result - failure - created_at - updated_at - started_at - finished_at 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_not_found: type: object properties: error: type: object properties: code: type: string enum: - not_found 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. ````