Update Profile By Profile Id

Connect API Catalog/

Update Profile By Profile Id

Request

Updates a single profile by profile Id.

Security

bearerToken

Path

profileIdstring, (uuid)required

Id of a profile.

Example:9a7ae0c8-f473-4ab6-8dbb-03fc061630cc

X-Team-Idstring, (uuid)

Optional. The team to work in, using a team id from List Teams. If left out, the default team is used. Records created in a team can only be seen by sending that team's id. A team id that doesn't exist, or a team being deleted, is rejected with 404 Team Not Found.

Example:6b78aed4-9ba6-441b-80b9-df9bea3b7c97

Bodyapplication/json

The profile fields to update.

namestring or nullrequired

The name of the profile to be updated.

riskRatingstring or nullrequired

Risk rating of the profile.

Enum:"notApplicable""veryLow""low""medium""high""veryHigh"null

Example:"notApplicable"

statusstring or nullrequired

Status of the profile.

Enum:"new""approved""declined""pending""cancelled""referred""closed""approvedReviewDue"null

Example:"new"

internalIdstring or null

Internal ID of the profile, this MUST be unique across your profiles.

assignedToIdinteger or null, (int32)

Creditsafe Id of the user to assign the profile to.
Passing null will unassign the profile.

kycReviewOnstring or null, (date)

The date to which the profile should be reviewed.
Format YYYY-MM-DD
Validates when the date changes and is either current or in the future.

Example:"2021-04-20"

kycCommentsstring or null

Free text field for users to highlight key information to other users.
Maximum characters allowed is 250

curl -i -X PUT \
  https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/profiles/9a7ae0c8-f473-4ab6-8dbb-03fc061630cc \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -H 'X-Team-Id: 6b78aed4-9ba6-441b-80b9-df9bea3b7c97' \
  -d '{
    "name": "Test Profile",
    "status": "pending",
    "riskRating": "medium",
    "kycComments": "Contract test - safe to delete"
  }'

Responses

Success

Bodyapplication/json

idstring, (uuid)

Id of the Profile

namestring

Name of the Profile

riskRatingstring

The risk rating being assigned to the profile

Enum:"notApplicable""veryLow""low""medium""high""veryHigh"

statusstring

Status of the profile (new, approved, declined, pending, cancelled, referred, closed, approvedReviewDue)

typestring

Type of the profile (trust, individual, soleTrader, company, plc, partnership, otherEntity)

internalIdstring or null

Internal Id of the profile.

assignedToIdinteger or null

Id of the user assigned to the profile

assignedTostring or null

Name of the user assigned to the profile

safeNumberstring or null

safe number of the business linked to the profile

companyIdstring or null

company id of the business linked to the profile

formationDatestring or null, (date)

Formation date of the business linked to the profile

createdAtstring, (date-time)

Profile created time

createdByIdinteger, (int32)

Id of the user who created the profile

createdBystring

Name of the user who created the profile

modifiedAtstring, (date-time)

Profile last updated time

modifiedByIdinteger, (int32)

Id of the user who last modified the profile

modifiedBystring

Name of the user who last modified the profile

kycApprovedAtstring or null, (date-time)

Date when the profile got approved

kycReviewOnstring or null, (date)

Date when profile is to be reviewed

kycStatusUpdatedOnstring, (date-time)

Date when the profile status was last updated

kycCommentsstring

Profile comments

noteCountinteger, (int32)

Count of notes associated with profile

attachmentCountinteger, (int32)

Count of attachments associated with profile

keyPartyCountinteger, (int32)

Count of key parties associated with profile

uboCountinteger, (int32)

Count of UBOs associated with profile

openAlertCountinteger, (int32)

Count of Open Alerts

modeOfCreationstring

Mode of profile creation (manual, import)

importStatusstring

Status of profile creation (submitted, preprocessed, validated, queued, inProgress, processed, completed, partiallyCompleted, failed)

isLockedboolean

Value indicating whether the profile is locked

isKycMonitoredboolean

Value indicating whether the profile is under KYC monitoring

correlationIdstring

A unique ID assigned to this request.

Response

{
  "id": "8cb4d8a3-d277-4205-9d6c-f3f3a8b65f31",
  "name": "Test Profile",
  "riskRating": "medium",
  "status": "pending",
  "type": "company",
  "internalId": null,
  "assignedToId": null,
  "assignedTo": null,
  "safeNumber": null,
  "companyId": null,
  "formationDate": null,
  "createdAt": "2026-11-03T14:40:04.857Z",
  "createdById": 100000001,
  "createdBy": "Jane Smith",
  "modifiedAt": "2026-11-03T14:40:05.366Z",
  "modifiedById": 100000001,
  "modifiedBy": "Jane Smith",
  "kycApprovedAt": null,
  "kycReviewOn": null,
  "kycStatusUpdatedOn": "2026-11-03T14:40:05.366Z",
  "kycComments": "Contract test - safe to delete",
  "noteCount": 0,
  "attachmentCount": 0,
  "keyPartyCount": 0,
  "uboCount": 0,
  "openAlertCount": 0,
  "modeOfCreation": "manual",
  "isLocked": false,
  "isKycMonitored": false,
  "correlationId": "b541d0f2-dda8-4e9e-8d9b-ecf3488aaf49"
}