# createDisputeFileEvidence

Mutation · GraphQL API

Uploads an evidence file and associates it with a dispute. **Note:**: file upload requires a special request format. See the ['Uploading Files' integration guide](https://graphql.braintreepayments.com/integration_guides/uploading_files) for instructions on how to perform this mutation.

## Authentication

- SERVER

## Input

- `input` (`CreateDisputeFileEvidenceInput!`) — required

## Returns [CreateDisputeFileEvidencePayload](/braintree/graphql/reference/types/create-dispute-file-evidence-payload)

Top-level field returned when creating file evidence for a dispute.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `evidence` (`DisputeFileEvidence`): The evidence object created.
- `dispute` (`Dispute`): Information about the dispute the evidence is attached to.

## Examples

### Create dispute file evidence

Top-level input fields for adding file evidence to a dispute.

```graphql
mutation createDisputeFileEvidence($input: CreateDisputeFileEvidenceInput!) {
  createDisputeFileEvidence(input: $input) {
    clientMutationId
    evidence {
      __typename
      id
      legacyId
      createdAt
      sentToProcessorAt
      url
      category
    }
    dispute {
      __typename
      id
      legacyId
      amountDisputed {
        value
        currencyCode
      }
      amountWon {
        value
        currencyCode
      }
      caseNumber
      createdAt
      receivedDate
      referenceNumber
      responseDeadline
      replyByDate
      type
      evidence {
        __typename
        ... on DisputeFileEvidence {
          __typename
          id
          legacyId
          createdAt
          sentToProcessorAt
          url
          category
        }
        ... on DisputeTextEvidence {
          __typename
          id
          legacyId
          createdAt
          sentToProcessorAt
          content
          category
        }
      }
      originalDispute {
        __typename
        id
        legacyId
      }
      processorResponse {
        processorComments
        reason
        reasonCode
        reasonDescription
        receivedDate
        referenceNumber
      }
      status
      statusHistory {
        disbursementDate
        status
        timestamp
        effectiveDate
      }
      transaction {
        __typename
        id
        legacyId
      }
      protectionLevel
      preDisputeProgram
      remainingFileEvidenceStorage
    }
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)