/v1/disputes/{dispute_id}/evidenceAuthentication
Bearer API key or Facily session, subject to permissions and facility scope.
Authentication and scopeRequest example
Replace bracketed path values with real IDs from your environment. The body, where shown, is generated from the schema and uses illustrative values.
curl --request POST \
--url 'https://api.staging.facily.ai/v1/disputes/<DISPUTE_ID>/evidence' \
--header "Authorization: Bearer $FACILY_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"document_id": "00000000-0000-4000-8000-000000000001",
"name": "string"
}'Parameters
dispute_idpath · stringrequiredFormat: uuid
Request body
application/json · Required
document_idstringrequiredA document in the dispute's facility: a PDF, JPEG, PNG or TIFF smaller than 10 MB.
Format: uuid
namestring | nullThe name the processor shows. Defaults to the document's title.
Max length: 255
Show name schema
string | nullThe name the processor shows. Defaults to the document's title.
Variant 1: string
stringVariant 2: null
nullResponses
Expand a status to inspect its schema. Generated examples show structure and synthetic values.
201Successful Response
{
"data": {
"created_at": "2026-10-29T12:00:00Z",
"dispute_id": "00000000-0000-4000-8000-000000000001",
"file_size_bytes": 0,
"id": "00000000-0000-4000-8000-000000000001",
"mime_type": "string",
"name": "string",
"document_id": "00000000-0000-4000-8000-000000000001",
"submitted_at": "2026-10-29T12:00:00Z"
},
"meta": {
"request_id": "string"
}
}application/json
dataDisputeEvidenceResponserequiredOne evidence file Facily sent to the processor for a dispute.
Show data schema
created_atstringrequiredWhen it was sent to the processor.
Format: date-time
dispute_idstringrequiredFormat: uuid
document_idstring | nullThe Facily document it was sent from. Null once that document is removed.
Format: uuid
Show document_id schema
string | nullThe Facily document it was sent from. Null once that document is removed.
Variant 1: string
stringVariant 2: null
nullfile_size_bytesintegerrequiredidstringrequiredFormat: uuid
mime_typestringrequirednamestringrequiredsubmitted_atstring | nullWhen it was submitted for review. Submitted evidence cannot be removed.
Format: date-time
Show submitted_at schema
string | nullWhen it was submitted for review. Submitted evidence cannot be removed.
Variant 1: string
stringVariant 2: null
nullmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired400Validation error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired401Unauthenticated
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired403Permission denied
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired404Not found
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired409Business logic error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired503Temporary failure
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired