Skip to main content
DELETE
/
partner
/
incorporation
/
{incorporationId}
/
participants
/
{participantId}
Remove an incorporation participant
curl --request DELETE \
  --url https://api.prod.commenda.io/api/v1/partner/incorporation/{incorporationId}/participants/{participantId} \
  --header 'x-api-key: <api-key>'
{
  "participantId": "participant_123",
  "incorporationValidation": {
    "isComplete": false,
    "missingRequirements": [
      {
        "code": "PARTICIPANT_DOCUMENT_REQUIRED",
        "path": "participants.participant_123.documents.PASSPORT_SCAN",
        "message": "Participant participant_123 requires a PASSPORT_SCAN document",
        "participantId": "participant_123",
        "displayName": "Jane Founder"
      }
    ],
    "invalidRequirements": [
      {
        "code": "PARTICIPANT_DOCUMENT_REQUIRED",
        "path": "participants.participant_123.documents.PASSPORT_SCAN",
        "message": "Participant participant_123 requires a PASSPORT_SCAN document",
        "participantId": "participant_123",
        "displayName": "Jane Founder"
      }
    ]
  }
}
Removes a participant registration from an incorporation. This removes the incorporation-specific participant record and its linked participant documents. It does not delete the underlying Commenda OS person or business entity referenced by the participant, so that reusable resource can still be used elsewhere. The response returns the removed participantId and the refreshed incorporationValidation for the incorporation.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
incorporationId
string
required

Incorporation identifier returned by create or list endpoints.

​
participantId
string
required

Incorporation-specific participant identifier returned by register, list, or read endpoints.

Response

Participant removed successfully

​
participantId
string
required

Incorporation-specific participant identifier that was removed.

Example:

"participant_123"

​
incorporationValidation
object
required