API Reference

Uploads API

POST /v1/uploads generates short-lived Google Cloud Storage signed PUT URLs for source documents.

Endpoint

Code
POST https://transpera-api-dev-vv55i7vbvq-el.a.run.app/v1/uploads

Request Body

fileNamestringrequired

Original filename with extension (e.g. 'contract.pdf', 'brief.docx'). Sanitized automatically.

contentTypestringrequired

MIME type (e.g. 'application/pdf', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document').

Response

Code
{
  "uploadId": "4a7b9c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
  "objectName": "keys/key-live/4a7b9c1d-2e3f.../contract.pdf",
  "url": "https://storage.googleapis.com/transpera-bucket/keys/...?...signed-query...",
  "method": "PUT"
}