Decide an approval

Redline API›Approvals

PATCHhttps://api.redline.example/v1/matters/{matter_id}/approvals/{approval_id}

AuthRequires authentication via bearerAuth.

Description

Records an approval or rejection for the current Approval Chain stage.

Request

cURLJavaScriptPython

Copy

curl -X PATCH "https://api.redline.example/v1/matters/mat_01JAZ6Q7K2/approvals/apr_01JAZ8M2F7" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "decision": "approved",
  "note": "Approved for the stated term and liability cap."
}'

const response = await fetch("https://api.redline.example/v1/matters/mat_01JAZ6Q7K2/approvals/apr_01JAZ8M2F7", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
      "decision": "approved",
      "note": "Approved for the stated term and liability cap."
    }),
});

import requests

response = requests.patch(
    "https://api.redline.example/v1/matters/mat_01JAZ6Q7K2/approvals/apr_01JAZ8M2F7",
    headers={
      "Authorization": "Bearer YOUR_TOKEN"
    },
    json={
      "decision": "approved",
      "note": "Approved for the stated term and liability cap."
    },
)

Response200JSONCopy

{
  "id": "apr_01JAZ8M2F7",
  "matter_id": "mat_01JAZ6Q7K2",
  "document_id": "doc_01JAZ7C3V9",
  "chain_id": "ach_01J8X2V6N1",
  "stage": 1,
  "status": "pending",
  "summary": "string",
  "requested_by": "usr_01J9M4X8D2",
  "requested_at": "2024-01-01T00:00:00Z",
  "due_at": "2024-01-01T00:00:00Z",
  "decided_by": null,
  "decided_at": "2024-01-01T00:00:00Z",
  "decision": "approved",
  "decision_note": "string"
}

Parameters

matter_idpathstringrequired

Matter identifier.

approval_idpathstringrequired

Approval stage identifier within the Matter.

Request body

application/jsonrequired

decisionbodystringrequired

notebodystring

Responses

200The decided approval stage.application/json

idstringrequired

matter_idstringrequired

document_idstringrequired

chain_idstringrequired

stageintegerrequired

statusstringrequired

summarystring | null

requested_bystringrequired

requested_atstring <date-time>required

due_atstring | null

decided_bystring | null

decided_atstring | null

decisionstring | null

decision_notestring | null

401The API key is missing, malformed, expired, or revoked.application/json

errorobjectrequired

403The API key does not have permission for this action.application/json

errorobjectrequired

404The resource was not found in the authenticated Workspace.application/json

errorobjectrequired

409The operation conflicts with the current resource state.application/json

errorobjectrequired

422One or more request fields are invalid.application/json

errorobjectrequired