Enviar um anexo
POST/attachments
Uploads a file to the workspace blob registry. Send as multipart/form-data with a file part and an optional title. Requires scope finance.attachments.write. Allowed types: pdf, png, jpg/jpeg, xml, ofx, csv, xlsx; max 10 MB. For PDF/PNG/JPEG the declared MIME must match the payload's magic bytes (mismatch → 422). The response is the same metadata shape as GET /attachments/{id}; link counts start at 0 — associate the file via POST /attachments/{id}/links. custom_metadata may ride along as a JSON string in the multipart body.
Requisição
Respostas
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
Attachment uploaded. The Location header points at the new row.
Body is not valid multipart/form-data.
Missing / invalid / expired / revoked token.
Token lacks the finance.attachments.write scope.
X-Idempotency-Key reused with a different body.
Missing file part, file too large, disallowed MIME type, or magic bytes that don't match the declared type.
Rate limit exceeded for this token. Reads and writes have separate budgets, both on a 1-hour sliding window. The response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and Retry-After — wait out Retry-After rather than retrying immediately.
Unhandled server error.