Create a draw
Creates a new draw on a project. Only name is required.
A draw is created in its initial state; to record state changes (including submission and funding) use PATCH /draws/{drawId}, and to answer the project's Draw Assessment Questions use PUT /draws/{drawId}/draw-assessment-responses.
Idempotency
This endpoint supports the optional Idempotency-Key header. A key identifies one request (method, path, and body). The key is reserved before the request executes, so a retry that races the original cannot create a duplicate draw. Repeating the same request with the same key replays the original response (status and body); until the original has recorded a result, the retry receives 409 with code IDEMPOTENCY_KEY_IN_FLIGHT and should retry after a short backoff. Reusing the key for a different request returns 409 with code IDEMPOTENCY_KEY_CONFLICT.
Once a key has begun executing it is never re-executed automatically. If a request fails before recording a result (e.g. a 5xx), its outcome is unresolved and the key stays in flight rather than being reused — this preserves the guarantee at the cost of that key: do not retry with a new key, which could duplicate; contact support to resolve it. Keys are scoped per service account.
Request
- Base URL: https://api.rabbet.com/v1
- URL: https://api.rabbet.com/v1/projects/{projectId}/draws
- Auth: OAuth 2 (client credentials, token URL https://api.rabbet.com/oauth/token, scopes: write)
Path parameters
Rabbet project UUID. To resolve your own identifier to a project, use GET /projects?custom_id=....
Headers
Optional client-supplied key making this request idempotent. Reuse the same value (for the same request) to safely retry without creating a duplicate draw.
Request body
Example request
{
"name": "Draw 9",
"expected_send_date": "2026-04-15",
"target_amount": {
"amount": "123.45",
"currency": "USD"
}
}Response
Draw created (or original response replayed for a reused Idempotency-Key).
Example response
{
"data": {
"id": "b308e77f-6d1d-47c4-bd1f-0069cc548315",
"name": "Draw 9",
"state_changed_at": "2026-09-30T14:03:11.204913Z",
"project_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
"target_amount": {
"amount": "123.45",
"currency": "USD"
},
"submitted_date": "2026-03-30",
"expected_send_date": "2026-04-15",
"submitter_id": "c408e77f-6d1d-47c4-bd1f-0069cc548316",
"created_at": "2026-06-04T09:12:33.000001Z"
}
}Changes
No recorded changes to this operation across all 1 revision of this API.