> ## 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 > Returns one item of the run. result is set once the item completes or is skipped; failed items have failure details instead. ## OpenAPI ````yaml /openapi.json get /v1/workflow-runs/{id}/items/{item_id} openapi: 3.1.0 info: title: Watchdog API version: 1.0.0 description: >- The Watchdog API is served from https://api.watchdog.no. Request bodies are limited to 2 MiB unless an endpoint says otherwise. Files are uploaded directly to storage, not through the API. servers: - url: https://api.watchdog.no description: Watchdog API security: [] paths: /v1/workflow-runs/{id}/items/{item_id}: get: tags: - Workflow runs summary: Get a workflow run item description: >- Returns one item of the run. result is set once the item completes or is skipped; failed items have failure details instead. operationId: getWorkflowRunItem parameters: - name: X-Organization-Id in: header required: false schema: type: string description: >- The organization to act in. Required for personal API keys; list the organizations you can access with GET /v1/organizations. - name: fields in: query required: false schema: type: string description: >- Return only these fields, comma-separated; use dots for nested fields, such as failure.code. id is always returned. Fields: id, run_id, retry_of_item_id, label, resource, status, result, failure, created_at, updated_at, started_at, finished_at. - 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: >- The item. A failed item is returned with 200 and its failure details. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. 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 label: 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: >- The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: '#/components/schemas/Error_validation_error' example: error: code: validation_error message: >- The request is invalid. details lists up to 20 field errors. Request bodies are limited to 2 MiB. request_id: req_example '401': description: The bearer token is missing or invalid. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. 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: The bearer token is missing or invalid. request_id: req_example '403': description: >- Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. content: application/json: schema: $ref: >- #/components/schemas/Error_forbidden_token_disabled_organization_required_insufficient_role_mfa_required example: error: code: forbidden message: >- Access denied. The error code says why: forbidden, token_disabled, organization_required, insufficient_role or mfa_required. 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 ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. 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: Too many requests. Wait for the Retry-After delay before retrying. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. 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: >- Too many requests. Wait for the Retry-After delay before retrying. 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 ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. 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: >- Temporarily unavailable. Retry after the Retry-After delay, when provided. headers: X-Request-Id: schema: type: string required: true description: >- Request ID, also included in error bodies. Include it when contacting support. Cache-Control: schema: type: string enum: - private, no-store - private, no-store, no-transform required: false description: API responses are private and must not be cached. X-RateLimit-Limit: schema: type: string example: '500' required: false description: >- Requests allowed per minute for this credential, or failed API key attempts allowed per minute from this IP address. 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: >- Temporarily unavailable. Retry after the Retry-After delay, when provided. request_id: req_example security: - ApiKeyBearer: [] 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 label: type: - string - 'null' description: >- The name of the item: agreement title, invoice number, file name, integration name or provider invoice key, when known. 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: - party_merge party_type: type: string enum: - supplier - recipient merged_id: type: string format: uuid required: - type - party_type - merged_id - 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 - 'null' 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: type: type: string enum: - invoice_credit_note_matching credit_note_id: type: string format: uuid outcome: type: string enum: - exact - verified - partial - no_candidates saved: type: integer minimum: 0 removed: type: integer minimum: 0 required: - type - credit_note_id - outcome - saved - removed - type: object properties: source_version: type: string strategy: type: string enum: - ocr - 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: - ocr - deterministic fallback_strategy: type: - string - 'null' enum: - ocr - deterministic - null limitations: type: array items: type: string required: - source_version - strategy - verification - type - document_id - requested_strategy - fallback_strategy - limitations - type: object properties: type: type: string enum: - document_index document_id: type: string format: uuid document_index_id: type: string format: uuid required: - type - document_id - document_index_id - 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 required: - type - compliance_check_id - invoice_id - agreement_id - finding_count - 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 required: - type - compliance_check_id - invoice_id - agreement_id - finding_count - 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 memberships_written: type: integer minimum: 0 description: How many alerts without a topic were put in one. required: - type - agreement_id - topics_created - topics_updated - 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 added as new prices. duplicate: type: integer minimum: 0 description: >- Rows skipped because the same product and price already exist. invalid: type: integer minimum: 0 description: Rows skipped because they break the price rules. replaced: type: integer minimum: 0 default: 0 description: >- Existing prices the import replaced, as its mode selected. required: - created - duplicate - invalid required: - type - price_import_id - counts - type: object properties: type: type: string enum: - agreement_document_import document_id: type: string format: uuid outcome: type: string enum: - attached - needs_role role: type: string enum: - terms - price_list - uncategorized - excluded suggested_role: type: - string - 'null' enum: - terms - price_list - uncategorized - excluded - null suggestion_reason: type: - string - 'null' preparation: type: string enum: - not_required - ready extraction_id: type: - string - 'null' format: uuid document_index_id: type: - string - 'null' format: uuid attachment_document_ids: type: array items: type: string format: uuid maxItems: 20 attachment_omissions: type: array items: type: string maxLength: 300 maxItems: 20 required: - type - document_id - outcome - role - suggested_role - suggestion_reason - preparation - extraction_id - document_index_id - attachment_document_ids - attachment_omissions additionalProperties: false - type: 'null' description: >- The item’s result, shaped by workflow type. Null until the item completes or is skipped. 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 - label - 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 sent as a bearer token, together with X-Organization-Id. The key must have at least the access level the endpoint requires (read, write or admin). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.