Skip to main content
POST
/
api
/
customer
/
{customerId}
/
risk-assessment
/
approval
changeApprovalStatus
curl --request POST \
  --url https://api.artemis.cynopsis.co/api/customer/{customerId}/risk-assessment/approval \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Domain-ID: <x-domain-id>' \
  --data '{
  "approvalStatus": "ACCEPTED",
  "assignTo": 123,
  "message": "<string>",
  "overrideRiskRating": "HIGH"
}'
{
  "approvalStatus": "ACCEPTED",
  "createdAt": {
    "date": 123,
    "day": 123,
    "hours": 123,
    "minutes": 123,
    "month": 123,
    "nanos": 123,
    "seconds": 123,
    "time": 123,
    "timezoneOffset": 123,
    "year": 123
  },
  "createdBy": {
    "email": "<string>",
    "firstName": "<string>",
    "fullName": "<string>",
    "id": 123,
    "lastName": "<string>"
  },
  "customerId": 123,
  "id": 123,
  "overrideRiskRating": "HIGH",
  "risk": {},
  "riskRating": "HIGH",
  "riskScore": 123,
  "updatedAt": {
    "date": 123,
    "day": 123,
    "hours": 123,
    "minutes": 123,
    "month": 123,
    "nanos": 123,
    "seconds": 123,
    "time": 123,
    "timezoneOffset": 123,
    "year": 123
  },
  "updatedBy": {
    "email": "<string>",
    "firstName": "<string>",
    "fullName": "<string>",
    "id": 123,
    "lastName": "<string>"
  }
}
This endpoint allows you to set or override the risk rating of a customer’s most recent risk assessment and update its approval status.
It is typically used by compliance officers to finalize or adjust the customer’s risk evaluation after review.

Path Parameter

Request Body Values

  • approvalStatus — Available values:
    • ACCEPTED
    • DRAFT
    • PENDING
    • REJECTED
    • REQUEST_CHANGES
  • overrideRiskRating — Available values:
    • HIGH
    • LOW
    • MEDIUM
    • MEDIUM_HIGH
    • MEDIUM_LOW
    • UNKNOWN

Example Request

curl -X POST "{{backend_url}}/api/customer/{{customerId}}/risk-assessment/approval" \
  -H "Authorization: Bearer <token>" \
  -H "X-Domain-ID: {{domain_id}}" \
  -H "Content-Type: application/json" \
  -d '{
    "overrideRiskRating": "LOW",
    "approvalStatus": "ACCEPTED"
  }'

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

X-Domain-ID
integer
required

X-Domain-ID

Path Parameters

customerId
integer
required

customerId

Query Parameters

authority
string
claims
object
domains[0].id
integer
domains[0].name
string
email
string
headers
object
scopes
string
tokenValue
string
userId
string

Body

application/json

requestDto

approvalStatus
enum<string>
required
Available options:
ACCEPTED,
CLEARED,
PENDING,
REJECTED,
REQUEST_CHANGES
overrideRiskRating
enum<string>
required
Available options:
HIGH,
LOW,
MEDIUM,
MEDIUM_HIGH,
MEDIUM_LOW,
UNKNOWN
assignTo
integer
message
string

Response

OK

approvalStatus
enum<string>
Available options:
ACCEPTED,
CLEARED,
PENDING,
REJECTED,
REQUEST_CHANGES
createdAt
object
createdBy
object
customerId
integer
id
integer
overrideRiskRating
enum<string>
Available options:
HIGH,
LOW,
MEDIUM,
MEDIUM_HIGH,
MEDIUM_LOW,
UNKNOWN
risk
object
riskRating
enum<string>
Available options:
HIGH,
LOW,
MEDIUM,
MEDIUM_HIGH,
MEDIUM_LOW,
UNKNOWN
riskScore
number
updatedAt
object
updatedBy
object