Upload a file directly from an agent or application

Preferred for an agent that has file bytes and authenticated HTTP access. Reuse its existing OAuth bearer token with quotes:write, send multipart fields file, service (optional; defaults to fax) and optional expectedSha256. Return HTTP 201 with a Document object directly: its id is the quote documentId. Validate the returned hash against the source. There is no user download/re-upload step and no arbitrary URL import. Stored upload acceptance does not guarantee a selected product or service can quote the file; quote preflight applies exact product dimensions/page limits and generates the final proof for approval. Uploading neither charges nor sends.

post/api/documents

Request

  • Base URL: https://postedly.com
  • URL: https://postedly.com/api/documents
  • Auth: HTTP bearer

Response

Validated document saved privately for the authenticated owner. This is the Document object itself, not an envelope.

idstring uuid required

Use this value as documentId in a quote; the person does not need to copy it.

namestring required
pagesinteger required

Inspected page count; images count as one. Upload PDFs allow up to 50 pages; service-specific quote limits can be lower.

bytesinteger required
sha256string required

Server-computed SHA-256 of the stored raw file bytes.

contentType'application/pdf' | 'image/jpeg' | 'image/png' required

Detected media type, not a trusted client declaration.

previewUrlstring uri-reference required

Private preview. Standard document URLs require the same owner’s bearer token; capability-scoped handoff URLs require their unexpired ticket. Resolve relative URLs against this API origin. Never make the file public to show a preview.

Changes

No recorded changes to this operation across all 1 revision of this API.