Update a request
Edit, assign, and move the status, in one call or apart. Editing is the owning side's admins' and editors'; the status, anyone's on the deal but a viewer. 403 `cannot_edit_request` / `cannot_transition`; 409 when the status can't go there.
Edit, assign, and move the status, in one call or apart. Editing is the owning
side's admins' and editors'; the status, anyone's on the deal but a viewer. 403
cannot_edit_request / cannot_transition; 409 when the status can't go there.
ApiKeyAuthorizationBearer <token>An API key from your organization's API Keys page in Cerclen.
request_id*Request Iduuiddeal_id*Deal Iduuidapplication/json- body
Only the fields you send change; null clears requester, due_date and
assignee_id. Editing is the owning side's admins' and editors'; moving the status,
anyone's on the deal but a viewer.
assignee_id?|nullbody?|nullcategory?|nulldue_date?|nullnumber?|Its number on the list. Omitted: the next number under its parent.
priority?|nullrequester?|nullstatus?|One of the request's allowed_statuses.
title?|nullSuccessful 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 PATCH 'https://app.cerclen.com/api/v1/deals/497f6eca-6276-4993-bfeb-53cbbbba6f08/requests/497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H "Authorization: Bearer $CERCLEN_KEY" \ -H 'Content-Type: application/json' \ -d '{ "assignee_id": "01a1d6c0-5f4e-7c1b-9a2d-3e4f5a6b7c8d", "due_date": "2026-11-30"}'{ "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"}