API-Referenz
proposals
16 Endpunkte in diesem Bereich. Jeder verfügt über eine eigene Seite mit seinen Parametern, seiner Antwort und einer Anfrage, die Sie ausführen können.
| Methode | Pfad | Funktionsweise | Berechtigung |
|---|---|---|---|
| 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. | agency.invoicing.view |
| PATCH | /v1/proposals/{proposalId} | Edit a proposal before it is accepted. | agency.invoicing.manage |
| POST | /v1/proposals/{proposalId}/complete | Mark the project finished. The room stays readable. | agency.invoicing.manage |
| POST | /v1/proposals/{proposalId}/resend-link | Replace the recipient's link and e-mail the new one. | agency.invoicing.manage |
| POST | /v1/proposals/{proposalId}/send | Issue the current edits as a new revision and e-mail the recipient a fresh link. | agency.invoicing.manage |
| POST | /v1/proposals/{proposalId}/withdraw | Take back a proposal that has not been accepted. | agency.invoicing.manage |
| GET | /v1/public/proposal-labels | The proposal page's labels in one language, with no proposal. Unauthenticated. | Kein API-Schlüssel |
| GET | /v1/public/proposals/{token} | The recipient's page — the document, its invoice and the project room. Unauthenticated. | Kein API-Schlüssel |
| POST | /v1/public/proposals/{token}/accept | Accept the newest revision. Raises its invoice in the same transaction. | Kein API-Schlüssel |
| POST | /v1/public/proposals/{token}/changes | Ask the sender for an amended proposal. | Kein API-Schlüssel |
| POST | /v1/public/proposals/{token}/decline | Decline the proposal, optionally saying why. | Kein API-Schlüssel |
| POST | /v1/public/proposals/{token}/files | Share a file into the project. Scanned before anyone can download it. | Kein API-Schlüssel |
| GET | /v1/public/proposals/{token}/files/{attachmentId} | Download a shared file — only once its virus scan has passed. | Kein API-Schlüssel |
| POST | /v1/public/proposals/{token}/messages | Post a message into the project thread. Visible to both parties. | Kein API-Schlüssel |