> ## 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. # Undo selected manual alert credits > Removes user credits without changing verdicts or claims. Qualifying invoice coverage becomes credit-note credit. A filter selects user credits only; an explicit credit-note credit returns 409. Select alerts with alert_ids or filter, at most 5000 per request. Retrying is safe. A filter must name topics, claims, agreements or invoices. Alerts in completed claims cannot be changed. ## OpenAPI ````yaml /openapi-preview.json post /v1/alerts/uncredit 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/alerts/uncredit: post: tags: - Alerts summary: Undo selected manual alert credits description: >- Removes user credits without changing verdicts or claims. Qualifying invoice coverage becomes credit-note credit. A filter selects user credits only; an explicit credit-note credit returns 409. Select alerts with alert_ids or filter, at most 5000 per request. Retrying is safe. A filter must name topics, claims, agreements or invoices. Alerts in completed claims cannot be changed. operationId: uncreditAlerts 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. requestBody: required: true content: application/json: schema: type: object properties: alert_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 5000 description: >- Alerts to change. If any is unknown (404) or cannot be changed (409), nothing changes. filter: type: object properties: mine: type: boolean description: >- Only records matched by the filters of teams you belong to. Teams combine with OR; other filters combine with AND. Cannot be combined with team_ids. team_ids: type: array items: type: string minItems: 1 maxItems: 50 description: >- Only records matched by the filters of these teams: at most 50, comma-separated in a query string or an array in a JSON body. Teams combine with OR. Unknown teams return 404. claim_ids: type: array items: type: string minItems: 1 maxItems: 50 description: >- Match alerts in any of these claims; null matches alerts in no claim. has_claim: type: boolean description: >- Use false to select alerts that are not currently attached to any claim. claim_statuses: type: array items: type: string enum: - pending - in_progress - completed - cancelled minItems: 1 maxItems: 50 description: >- Match alerts whose current claim has any of these statuses. join_operator: type: string enum: - and - or description: >- Combine invoice, agreement, supplier, recipient and topic ID filters with AND (default) or OR. Tenant, validity, search and other filters always apply. invoice_operator: type: string enum: - is - is_not agreement_operator: type: string enum: - is - is_not supplier_operator: type: string enum: - is - is_not recipient_operator: type: string enum: - is - is_not topic_operator: type: string enum: - is - is_not invoice_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 50 agreement_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 50 agreement_statuses: type: array items: type: string enum: - draft - active - archived minItems: 1 maxItems: 50 description: Match alerts whose agreement has any of these statuses. supplier_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 50 recipient_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 50 tag_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 50 topic_ids: type: array items: type: string minItems: 1 maxItems: 50 description: >- Match alerts in any selected topic; null matches uncategorized alerts. has_topic: type: boolean description: Use false to select uncategorized alerts. verdicts: type: array items: type: string enum: - pending - accepted - dismissed minItems: 1 maxItems: 50 description: >- Match alerts with any of these verdicts, whatever their credit. credited: type: boolean description: >- Match alerts with or without a credit, regardless of verdict. credit_sources: type: array items: type: string enum: - credit_note - user - 'null' minItems: 1 maxItems: 50 description: >- Match credit provenance; null selects alerts without a credit. confidence_levels: type: array items: type: string enum: - high - mid - low - 'null' minItems: 1 maxItems: 50 description: >- Match any listed confidence level; null matches alerts without one. currency_codes: type: array items: type: string pattern: ^[A-Z]{3}$ minItems: 1 maxItems: 50 correction_types: type: array items: type: string enum: - modify_item - modify_invoice - add_item minItems: 1 maxItems: 50 freshness: type: string enum: - current - outdated - unknown validity: type: string enum: - live - invalidated - all description: >- live (default) returns alerts that count; invalidated returns alerts that stopped counting, for example because their invoice no longer matches the agreement. Alerts in claims named by claim_ids are included either way. impact_min: type: string maxLength: 100 pattern: ^-?\d+(?:\.\d+)?$ description: >- Minimum impact in the organization currency, inclusive. Alerts without an impact never match. impact_max: type: string maxLength: 100 pattern: ^-?\d+(?:\.\d+)?$ description: >- Maximum impact in the organization currency, inclusive. Alerts without an impact never match. issued_from: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: Invoice issued on or after this date. issued_through: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: Invoice issued on or before this date. created_from: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Created on or after this calendar date in the organization's timezone. created_through: type: string pattern: ^\d{4}-\d{2}-\d{2}$ description: >- Created on or before this calendar date in the organization's timezone. search: type: string minLength: 1 maxLength: 200 description: >- Case-insensitive search across alert, invoice, supplier, agreement and topic text. A UUID matches the alert, invoice, supplier or agreement ID. additionalProperties: false description: >- Change every alert matching these GET /v1/alerts filters, given as JSON lists and booleans. Matching alerts that cannot be changed are skipped and counted in skipped_count. excluded_alert_ids: type: array items: type: string format: uuid minItems: 1 maxItems: 5000 description: >- Alerts to leave out of a filter selection. Only valid with filter. additionalProperties: false responses: '200': description: >- How many alerts changed and how many matching alerts were left alone. 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/AlertSelectionResult' '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: An alert in alert_ids or a selected team was not found. 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: An alert in alert_ids or a selected team was not found. request_id: req_example '409': description: >- An alert in alert_ids cannot be changed (for example, it is in a completed claim), the filter selects too many alerts, or a selected team has invalid saved filters. Nothing changed. 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' example: error: code: conflict message: >- An alert in alert_ids cannot be changed (for example, it is in a completed claim), the filter selects too many alerts, or a selected team has invalid saved filters. Nothing changed. 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: AlertSelectionResult: type: object properties: changed_count: type: integer description: >- Alerts the command changed. Alerts already in the requested state are not counted. skipped_count: type: integer description: Matching alerts a filter left unchanged. Always 0 for alert_ids. required: - changed_count - skipped_count 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: type: object properties: error: type: object properties: code: type: string enum: - conflict 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). ````