> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decisionly.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Set claim cases

> Replaces all cases in a claim with the supplied list.



## OpenAPI

````yaml /api-reference/v2/openapi.yaml put /v2/issuer/claims/{claim_id}/cases
openapi: 3.0.0
info:
  title: Decisionly API v2
  description: Claims-based API for submission and handling of chargebacks by issuers.
  version: 2.0.0
servers:
  - url: https://api.decisionly.com
    description: Production server. Use your test key for the sandbox environment.
security:
  - basicAuth: []
tags:
  - name: v2 Cases
    description: Case management endpoints
  - name: v2 Claims
    description: Claim management endpoints
  - name: v2 Events
    description: Event endpoints
  - name: v2 Files
    description: File upload endpoints
  - name: v2 Beta
    description: Beta features - These endpoints are experimental and subject to change
paths:
  /v2/issuer/claims/{claim_id}/cases:
    put:
      tags:
        - v2 Claims
      summary: Set claim cases
      description: Replaces all cases in a claim with the supplied list.
      parameters:
        - name: claim_id
          in: path
          required: true
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                case_ids:
                  type: array
                  description: >-
                    Complete array of case IDs that should be in this claim.
                    This replaces the existing cases.
                  items:
                    type: string
                  minItems: 1
                  example:
                    - case_xyz789
                    - case_mno012
                    - case_abc123
              required:
                - case_ids
      responses:
        '200':
          description: Successfully updated the claim cases.
          content:
            application/json:
              schema:
                type: object
                properties:
                  cases:
                    type: array
                    description: All cases now in the claim.
                    items:
                      type: object
                      properties:
                        case_id:
                          type: string
                  claim_id:
                    type: string
              example:
                cases:
                  - case_id: case_xyz789
                  - case_id: case_mno012
                  - case_id: case_abc123
                claim_id: claim_abc123
        '400':
          description: Bad request - validation errors.
          content:
            application/json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        details:
                          type: object
                        message:
                          type: string
                  message:
                    type: string
              examples:
                missing_case_ids:
                  summary: case_ids parameter missing or invalid
                  value:
                    errors:
                      - code: parameter_missing
                        details:
                          field: case_ids
                        message: case_ids is required and must be an array of case IDs.
                    message: Invalid data.
                cases_not_found:
                  summary: Some cases do not exist
                  value:
                    errors:
                      - code: parameter_invalid
                        details:
                          field: case_ids
                        message: 'Cases not found: case_xyz789'
                    message: Invalid data.
                invalid_claim_validation:
                  summary: Cases don't meet claim-level constraints
                  value:
                    errors:
                      - code: parameter_invalid
                        message: >-
                          All cases in a non-fraud claim must have the same
                          merchant
                    message: Invalid claim.
        '404':
          description: Claim not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
              example:
                message: Claim not found.
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Use your API key as the username. No password is required.

````