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

# Upload evidence to a case

> Upload one file to a case with a short description.



## OpenAPI

````yaml /api-reference/api.yaml post /evidence/uploads/create
openapi: 3.0.3
info:
  title: api
  description: >-
    The API service is the secure public gateway to our platform, letting people
    access features without touching our private internal APIs. It authenticates
    clients with its own internal tokens and then routes their requests to the
    right internal services behind the scenes.
  version: 1.0.0
servers:
  - url: https://api.platform.arb.inc
security: []
tags:
  - name: cases
  - name: docket
  - name: evidence
  - name: filings
  - name: organization
  - name: participants
  - name: schemas
  - name: service-of-notice
paths:
  /evidence/uploads/create:
    post:
      tags:
        - evidence
      summary: Upload evidence to a case
      description: Upload one file to a case with a short description.
      operationId: postEvidenceUploadsCreate
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              required:
                - caseID
                - description
                - file
              properties:
                caseID:
                  type: string
                  description: >-
                    ID of the case to attach the evidence to. Must be sent
                    before the file part.
                  example: 2025-08-00123
                description:
                  type: string
                  description: >-
                    Short description of the evidence. Must be sent before the
                    file part.
                  example: Photo from the incident on May 5, 2025
                makePublic:
                  type: string
                  description: >-
                    Whether to immediately add the evidence to the docket before
                    the evidence exchange phase.
                  enum:
                    - 'true'
                    - 'false'
                  example: 'true'
                file:
                  type: string
                  format: binary
                  description: The evidence file to upload (single file only).
                  example: (binary file contents)
            encoding:
              caseID:
                contentType: text/plain
              description:
                contentType: text/plain
              makePublic:
                contentType: text/plain
              file:
                contentType: application/pdf
      responses:
        '200':
          description: Evidence successfully uploaded.
          content:
            application/json:
              schema:
                type: object
                properties:
                  uploadID:
                    type: string
                    description: ID of the created evidence upload.
                    example: '12'
        '403':
          description: User is not allowed to upload in this case.
          content:
            text/plain:
              schema:
                type: string
                example: you cannot upload evidence in this case
        '404':
          description: Case not found or user not a participant.
          content:
            text/plain:
              schema:
                type: string
                example: case not found
        '410':
          description: Evidence submission window is closed for the case.
          content:
            text/plain:
              schema:
                type: string
                example: evidence submission is currently closed
        '411':
          description: The party has reached the maximum number of evidence uploads.
          content:
            text/plain:
              schema:
                type: string
                example: maximum number of evidence uploads reached
        '412':
          description: The uploaded file is too large.
          content:
            text/plain:
              schema:
                type: string
                example: uploaded file size is too large
        '413':
          description: File not supported.
          content:
            text/plain:
              schema:
                type: string
                example: file not supported
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````