Create an approval request | Monite Documentation

curl -X POST https://api.sandbox.monite.com/v1/approval_requests \
     -H "x-monite-version: 2024-05-25" \
     -H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "object_id": "object_id",
  "object_type": "account",
  "required_approval_count": 1,
  "role_ids": [
    "role_ids"
  ]
}'

{
  "id": "id",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "approved_by": [
    "approved_by"
  ],
  "created_by": "ea837e28-509b-4b6a-a600-d54b6aa0b1f5",
  "object_id": "object_id",
  "object_type": "account",
  "required_approval_count": 1,
  "role_ids": [
    "role_ids"
  ],
  "status": "waiting",
  "user_ids": [
    "user_ids"
  ],
  "rejected_by": "rejected_by"
}

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

x-monite-versionstringRequired

x-monite-entity-idstringRequired

The ID of the entity that owns the requested resource.

Request

This endpoint expects an object.

objectRequired

Response

Successful Response

idstringformat: "uuid"

created_atdatetime

updated_atdatetime

approved_bylist of strings

created_bystringformat: "uuid"

ID of the user who created the approval request

object_idstringformat: "uuid"

object_typeenum

required_approval_countinteger>=1

role_idslist of strings

statusenum

Allowed values:

user_idslist of strings

rejected_bystringformat: "uuid"

Errors

400

Post Approval Requests Request Bad Request Error

401

Post Approval Requests Request Unauthorized Error

403

Post Approval Requests Request Forbidden Error

404

Post Approval Requests Request Not Found Error

406

Post Approval Requests Request Not Acceptable Error

422

Post Approval Requests Request Unprocessable Entity Error

429

Post Approval Requests Request Too Many Requests Error