Skip to main content
POST
Upload evidence files

Authorizations

Authorization
string
header
required

You can use an OAuth2 JWT bearer token in the Authorization header of your API requests for supported endpoints: Authorization: Bearer <YOUR_JWT_HERE>. These tokens are valid for 10 minutes and can be requested via the access token endpoint endpoint.

Headers

x-idempotency-key
string<uuid>
required

Idempotency key to be used. Sending again the same key would return the same result without re-executing the update.

Path Parameters

disputeId
string<uuid>
required

Identifier of the resource in Payrails.

Body

multipart/form-data

Evidence to upload for the dispute. Provide at least one of files[] (binary file uploads) or inlineContexts (inline JSON context); both may be combined in a single request. A request with neither is rejected.

files[]
object[]

List of files supporting the dispute defense.

inlineContexts
object[]

Inline merchant-context evidences supplied as a JSON array in a single inlineContexts form field. Each item is stored as JSON evidence with no uploaded file. Maximum 10 items.

Response

Dispute evidences uploaded.

evidences
object[]
required
failedEvidences
object[]
required
classifications
object[]

AI classifications for the uploaded evidence files. Present for each file where classification completed (status "classified" or "failed"). Omitted when the evidence agent feature is not enabled.

Last modified on October 7, 2026