Upload a document
POST
/api/v1/documents
const url = 'https://sign-api.binarybridges.co/api/v1/documents';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"file":"binary"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://sign-api.binarybridges.co/api/v1/documents \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "file": "binary" }'Multipart. Uploads to organisation storage without attaching to an envelope; counts against the organisation’s storage quota.
Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Query Parameters
Sección titulada «Query Parameters»orgId
string format: uuid
Request Body
Sección titulada «Request Body»Media typeapplication/json
object
file
required
string format: binary
Example generated
{ "file": "binary"}Responses
Sección titulada «Responses»Created
Media type*/*
object
contentType
required
string
createdAt
required
string format: date-time
filename
required
string
id
required
string format: uuid
sizeBytes
integer format: int64
The request was malformed or failed validation.
Media typeapplication/json
object
code
required
string
error
required
string
message
required
string
path
required
string
quota
object
current
required
integer format: int64
dimension
required
string
limit
required
integer format: int64
status
required
integer format: int32
timestamp
required
string format: date-time
traceId
string
Example generated
{ "code": "example", "error": "example", "message": "example", "path": "example", "quota": { "current": 1, "dimension": "example", "limit": 1 }, "status": 1, "timestamp": "2026-04-15T12:00:00Z", "traceId": "example"}No credentials, or a token this organisation’s credentials cannot present. Produced by the security filter chain, so there is no response body.
Authenticated, but the token lacks the role this operation requires. No response body.
The resource is not in a state that allows this — for example sending an envelope that is already sent.
Media typeapplication/json
object
code
required
string
error
required
string
message
required
string
path
required
string
quota
object
current
required
integer format: int64
dimension
required
string
limit
required
integer format: int64
status
required
integer format: int32
timestamp
required
string format: date-time
traceId
string
Example generated
{ "code": "example", "error": "example", "message": "example", "path": "example", "quota": { "current": 1, "dimension": "example", "limit": 1 }, "status": 1, "timestamp": "2026-04-15T12:00:00Z", "traceId": "example"}A domain rule rejected the request.
Media typeapplication/json
object
code
required
string
error
required
string
message
required
string
path
required
string
quota
object
current
required
integer format: int64
dimension
required
string
limit
required
integer format: int64
status
required
integer format: int32
timestamp
required
string format: date-time
traceId
string
Example generated
{ "code": "example", "error": "example", "message": "example", "path": "example", "quota": { "current": 1, "dimension": "example", "limit": 1 }, "status": 1, "timestamp": "2026-04-15T12:00:00Z", "traceId": "example"}An organisation quota is exhausted.
Media typeapplication/json
object
code
required
string
error
required
string
message
required
string
path
required
string
quota
object
current
required
integer format: int64
dimension
required
string
limit
required
integer format: int64
status
required
integer format: int32
timestamp
required
string format: date-time
traceId
string
Example generated
{ "code": "example", "error": "example", "message": "example", "path": "example", "quota": { "current": 1, "dimension": "example", "limit": 1 }, "status": 1, "timestamp": "2026-04-15T12:00:00Z", "traceId": "example"}