API Reference

Get an upload URL for a document

post
https://api.muralpay.com/api/documents/generate-upload-url

Returns a one-time upload URL plus the form fields you need to attach. Send a multipart/form-data POST to the URL with each uploadUrlFormFields entry as a form field, then the file field last. The URL is valid for 15 minutes. Maximum file size is 10 MB.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Human-readable filename for the document

string
enum
required

The MIME type of the document

Allowed:
Headers
string

Organization ID to act on behalf of

uuid
required

Required UUID to safely retry requests without creating duplicate operations. Subsequent requests with the same key and identical body return the original cached response with an idempotency-replayed: true response header. Keys expire after 24 hours.

Responses

400

Missing or invalid idempotency-key — the header is required and must be a valid UUID.

401

Unauthorized

409

IdempotencyConflictError

422

IdempotencyKeyExpiredError

Updated 28 days ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 28 days ago