Create a request
The owning side's admins and editors raise requests. 403 `cannot_create_request`.
The owning side's admins and editors raise requests. 403 cannot_create_request.
ApiKeyAuthorizationBearer <token>An API key from your organization's API Keys page in Cerclen.
deal_id*Deal Iduuidapplication/json- body
A new request (or section). Raised by the owning side's admins and editors.
assignee_id?|A person id from the deal's people.
body?BodyThe request in full, in Markdown.
length <= 20000""category?RequestCategoryThe DRL's workstreams (ADR-0031). Shown with the firm raising the request — "Legal - Kirkland & Ellis" — or "Financial Sponsor" when none is named.
"business""business""legal""tax""accounting""technology""human_resources"due_date?|nullkind?RequestKindA row of the list (ADR-0017): a request, or a section heading that groups the requests under it — a number and a title, never a status, an assignee or an answer.
"request""request""section"number?|Its number on the list. Omitted: the next number under its parent.
parent_id?|The section to put it under.
priority?PriorityA request's urgency. Ordering for display is client-side (never ORDER BY).
"medium""low""medium""high"requester?|The advisor firm raising it; null for the Financial Sponsor.
title*Title\S1 <= length <= 500Successful Response
application/json- response
A request on the deal's list. A section is a heading over requests: it has no
status, assignee or answers of its own.
allowed_statuses*array<>The statuses you may move it to from here.
assignee_id*|The person id of whoever is to answer it.
body*BodyThe request in full, in Markdown.
can*What you may do to this request.
category*RequestCategoryThe DRL's workstreams (ADR-0031). Shown with the firm raising the request — "Legal - Kirkland & Ellis" — or "Financial Sponsor" when none is named.
"business""legal""tax""accounting""technology""human_resources"created_at*Created Atdate-timedue_date*|A calendar day in the deal's time zone.
files*array<>Every file and link given in answer to it.
id*Idkind*RequestKindA row of the list (ADR-0017): a request, or a section heading that groups the requests under it — a number and a title, never a status, an assignee or an answer.
"request""section"latest_answer*|nullnumber*NumberIts number on the list, such as 3.2.
parent_id*|The section it sits under; null at the top level.
priority*PriorityA request's urgency. Ordering for display is client-side (never ORDER BY).
"low""medium""high"requester*|The advisor firm raising it; null for the Financial Sponsor.
status*RequestStatus"open""partial""complete"status_changed_at*|nulltitle*Titleupdated_at*Updated Atdate-timecurl -X POST 'https://app.cerclen.com/api/v1/deals/497f6eca-6276-4993-bfeb-53cbbbba6f08/requests' \ -H "Authorization: Bearer $CERCLEN_KEY" \ -H 'Content-Type: application/json' \ -d '{ "body": "Including the auditor'\''s management letters.", "category": "accounting", "due_date": "2026-11-30", "number": "3.2", "priority": "high", "title": "Audited financial statements, last three years"}'{ "allowed_statuses": [ "open" ], "assignee_id": "string", "body": "string", "can": { "answer": true, "assign": true, "change_status": true, "edit": true }, "category": "business", "created_at": "2019-08-24T14:15:22Z", "due_date": "2019-08-24", "files": [ { "content_type": "string", "downloadable": true, "kind": "file", "name": "string", "size": 0, "url": "string", "version_id": "string" } ], "id": "string", "kind": "request", "latest_answer": { "author": { "email": "string", "id": "string", "name": "string" }, "message_id": "string", "partial": true, "posted_at": "2019-08-24T14:15:22Z", "preview": "string", "source": "email" }, "number": "string", "parent_id": "string", "priority": "low", "requester": "string", "status": "open", "status_changed_at": "2019-08-24T14:15:22Z", "title": "string", "updated_at": "2019-08-24T14:15:22Z"}