> ## 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. # Import prices from Documents > Reads the prices in 1–200 documents linked to this agreement and adds them, in one workflow run. Each document has its own worksheets, instructions and default currency, and succeeds or fails on its own. Duplicates and rows that break the price rules are skipped; mode decides whether existing prices are replaced. Importing a document again with the same file and settings returns its existing import (reused) and starts nothing. Repeating a request with the same Idempotency-Key returns its original result. Follow the run, and read each price import for its outcome; afterwards you can download every extracted row with its outcome. ## OpenAPI ````yaml /openapi-preview.json post /v1/agreements/{id}/price-imports openapi: 3.1.0 info: title: Watchdog API version: 1.0.0 description: >- The Watchdog API is served from https://api-canary.watchdog.no until it moves to 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-canary.watchdog.no description: Watchdog API security: [] paths: /v1/agreements/{id}/price-imports: post: tags: - Agreement price imports summary: Import prices from Documents description: >- Reads the prices in 1–200 documents linked to this agreement and adds them, in one workflow run. Each document has its own worksheets, instructions and default currency, and succeeds or fails on its own. Duplicates and rows that break the price rules are skipped; mode decides whether existing prices are replaced. Importing a document again with the same file and settings returns its existing import (reused) and starts nothing. Repeating a request with the same Idempotency-Key returns its original result. Follow the run, and read each price import for its outcome; afterwards you can download every extracted row with its outcome. operationId: createAgreementPriceImport 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. - schema: type: string format: uuid required: true name: id in: path - schema: type: string minLength: 1 maxLength: 200 pattern: ^[\x21-\x7e]+$ description: >- Optional protection for safely retrying a request after a timeout or lost response. Choose a unique value (for example, a UUID) for each action and reuse it with the same input when retrying. Omit it for a normal request. required: false description: >- Optional protection for safely retrying a request after a timeout or lost response. Choose a unique value (for example, a UUID) for each action and reuse it with the same input when retrying. Omit it for a normal request. name: idempotency-key in: header requestBody: required: true content: application/json: schema: type: object properties: entries: type: array items: type: object properties: document_id: type: string format: uuid description: A document linked to this agreement. worksheets: type: - array - 'null' items: type: string minLength: 1 maxLength: 31 minItems: 1 maxItems: 500 default: null description: >- Excel worksheets to read, by exact name. Null reads every worksheet. instructions: type: - string - 'null' maxLength: 20000 default: null description: >- Guidance for reading this document, e.g. which table or price column applies. default_currency: type: - string - 'null' pattern: ^[A-Z]{3}$ default: null description: >- Currency for prices whose source states none (ISO 4217). required: - document_id additionalProperties: false minItems: 1 maxItems: 200 description: >- 1–200 distinct documents linked to this agreement, each with its own settings. mode: type: string enum: - add - replace_document - replace_all default: add description: >- add keeps existing prices; replace_document replaces the prices earlier imports of each document created; replace_all replaces every price on the agreement, once. Nothing is deleted unless an import finds valid prices. extract_again: type: boolean default: false description: >- Read the file again instead of reusing the rows from an earlier import of the same file and settings. required: - entries additionalProperties: false example: entries: - document_id: 11111111-1111-4111-8111-111111111111 worksheets: - Prices 2026 default_currency: NOK responses: '200': description: >- Every file reused an existing import, or the Idempotency-Key was used before; nothing new started. 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: type: object properties: workflow_run_id: type: - string - 'null' format: uuid entries: type: array items: type: object properties: document_id: type: string format: uuid admission: type: string enum: - created - reused price_import: $ref: '#/components/schemas/AgreementPriceImport' required: - document_id - admission - price_import required: - workflow_run_id - entries '202': description: Import started for at least one file. 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. Location: schema: type: string required: false description: >- Relative URL of the workflow run for the new imports. Absent when every file reused an existing import. content: application/json: schema: type: object properties: workflow_run_id: type: - string - 'null' format: uuid entries: type: array items: type: object properties: document_id: type: string format: uuid admission: type: string enum: - created - reused price_import: $ref: '#/components/schemas/AgreementPriceImport' required: - document_id - admission - price_import required: - workflow_run_id - entries '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 '409': description: A document file is missing or changed. Upload it again. 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_conflict_source_unavailable' example: error: code: conflict message: A document file is missing or changed. Upload it again. 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: >- The import could not be confirmed as started. Check the workflow run at Location 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. Location: schema: type: string required: false description: >- Relative URL of the workflow run for the new imports. Absent when every file reused an existing import. content: application/json: schema: $ref: '#/components/schemas/Error_service_unavailable' example: error: code: service_unavailable message: >- The import could not be confirmed as started. Check the workflow run at Location before retrying. request_id: req_example security: - ApiKeyBearer: [] components: schemas: AgreementPriceImport: type: object properties: id: type: string format: uuid agreement_id: type: string format: uuid document_id: type: string format: uuid description: The document the prices were read from. origin: type: string enum: - workflow - legacy description: >- legacy imports are older imports with no workflow run, row counts or price table. worksheets: type: - array - 'null' items: type: string instructions: type: - string - 'null' default_currency: type: - string - 'null' mode: type: string enum: - add - replace_document - replace_all description: >- Which existing prices the import replaces: none (add), those from earlier imports of this document (replace_document), or all (replace_all). status: type: string enum: - queued - running - completed - failed - cancelled description: Failed and cancelled imports add no prices. counts: type: - object - 'null' 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 description: Existing prices the import replaced, as its mode selected. required: - created - duplicate - invalid - replaced description: Row outcomes. Null until the import completes. failure: type: - object - 'null' properties: code: type: string minLength: 1 maxLength: 100 message: type: string minLength: 1 maxLength: 2000 required: - code - message description: Why the import failed. Import again to retry. extraction_source_import_id: type: - string - 'null' format: uuid description: >- The earlier import whose rows this import reused instead of reading the same file again. Null when it read the file itself. workflow_run_id: type: - string - 'null' format: uuid workflow_run_item_id: type: - string - 'null' format: uuid created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - agreement_id - document_id - origin - worksheets - instructions - default_currency - mode - status - counts - failure - extraction_source_import_id - workflow_run_id - workflow_run_item_id - created_at - updated_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_conflict_source_unavailable: type: object properties: error: type: object properties: code: type: string enum: - conflict - source_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 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). ````