Propose a request
An editor on the running side raises a request for one of the deal's admins to file. 403 `cannot_propose_request` for anyone else — an admin files at once with `POST /deals/{deal_id}/requests`; 422 `unknown_category`.
An editor on the running side raises a request for one of the deal's admins to
file. 403 cannot_propose_request for anyone else — an admin files at once with
POST /deals/{deal_id}/requests; 422 unknown_category.
ApiKeyAuthorizationBearer <token>An API key from your organization's API Keys page in Cerclen.
deal_id*Deal Iduuidapplication/json- body
A request to propose: the same fields as a new request. An editor's way of
raising one; an admin files with POST /deals/{deal_id}/requests instead.
assignee_id?|A person id on the deal.
body?BodyThe request in full, in Markdown.
length <= 20000""category?|The category by name instead.
category_id?|One of the deal's categories (see the deal). Neither this nor category: General Business. Editors make no categories, so it must exist.
due_date?|nullpriority?PriorityA request's urgency. Ordering for display is client-side (never ORDER BY).
"medium""low""medium""high"requester?|The advisor firm raising it.
title*Title\S1 <= length <= 500Successful Response
application/json- response
A request an editor proposed, for one of the deal's admins to file or decline. It has no number until approved, when it becomes a request; the other side never sees it.
assignee_id*|The person id of whoever would answer it.
body*BodyThe request in full, in Markdown.
can*What you may do to this proposal.
category*CategoryThat category's name.
category_id*|The deal's category it would be filed under.
created_at*Created Atdate-timedecided_at*|nulldue_date*|nullid*Idpriority*PriorityA request's urgency. Ordering for display is client-side (never ORDER BY).
"low""medium""high"proposed_by_id*Proposed By IdThe person id of whoever proposed it.
reason*|Why it was declined.
request_id*|The request it became, once approved.
requester*|The advisor firm raising it; null for the Financial Sponsor.
state*ProposalStatepending, then approved, declined or withdrawn.
"pending""approved""declined""withdrawn"title*Titlecurl -X POST 'https://app.cerclen.com/api/v1/deals/497f6eca-6276-4993-bfeb-53cbbbba6f08/proposals' \ -H "Authorization: Bearer $CERCLEN_KEY" \ -H 'Content-Type: application/json' \ -d '{ "title": "string"}'{ "assignee_id": "string", "body": "string", "can": { "decide": true, "withdraw": true }, "category": "string", "category_id": "string", "created_at": "2019-08-24T14:15:22Z", "decided_at": "2019-08-24T14:15:22Z", "due_date": "2019-08-24", "id": "string", "priority": "low", "proposed_by_id": "string", "reason": "string", "request_id": "string", "requester": "string", "state": "pending", "title": "string"}