API reference
proposals
16 endpoints in this area. Each one has its own page with its parameters, its response and a request you can run.
| Method | Path | What it does | Permission |
|---|---|---|---|
| GET | /v1/proposals | The proposals this organisation has written — draft, sent, accepted and running. | agency.invoicing.view |
| POST | /v1/proposals | Draft a proposal. Nothing is sent until send. | agency.invoicing.manage |
| GET | /v1/proposals/{proposalId} | One proposal, with its lines, live invoice and full audit trail. | — |
| PATCH | /v1/proposals/{proposalId} | Edit a proposal before it is accepted. | — |
| POST | /v1/proposals/{proposalId}/complete | Mark the project finished. The room stays readable. | — |
| POST | /v1/proposals/{proposalId}/resend-link | Replace the recipient's link and e-mail the new one. | — |
| POST | /v1/proposals/{proposalId}/send | Issue the current edits as a new revision and e-mail the recipient a fresh link. | — |
| POST | /v1/proposals/{proposalId}/withdraw | Take back a proposal that has not been accepted. | — |
| GET | /v1/public/proposal-labels | The proposal page's labels in one language, with no proposal. Unauthenticated. | — |
| GET | /v1/public/proposals/{token} | The recipient's page — the document, its invoice and the project room. Unauthenticated. | — |
| POST | /v1/public/proposals/{token}/accept | Accept the newest revision. Raises its invoice in the same transaction. | — |
| POST | /v1/public/proposals/{token}/changes | Ask the sender for an amended proposal. | — |
| POST | /v1/public/proposals/{token}/decline | Decline the proposal, optionally saying why. | — |
| POST | /v1/public/proposals/{token}/files | Share a file into the project. Scanned before anyone can download it. | — |
| GET | /v1/public/proposals/{token}/files/{attachmentId} | Download a shared file — only once its virus scan has passed. | — |
| POST | /v1/public/proposals/{token}/messages | Post a message into the project thread. Visible to both parties. | — |