Update Contract Contact Person

Updates an existing contact person for a specific contract.

Endpoint

PATCH /contracts/{contractId}/contact-persons/{id}

Authentication

Required: Authorization header with valid token

Path Parameters

ParameterTypeRequiredDescription
contractIduuidYesContract unique identifier
iduuidYesContact person unique identifier

Request Body

{
  "name": "string",
  "position": "string",
  "phone": "string",
  "email": "string",
  "isMain": "boolean",
  "externalId": "string"
}

All fields are optional. Only the fields provided will be updated.

Field Descriptions:

  • name - Contact person's name
  • position - Contact person's job position or title
  • phone - Contact person's phone number
  • email - Contact person's email address (validated as email format)
  • isMain - Whether this is the primary contact person for the contract. Only one contact person per contract can be marked as main
  • externalId - External system identifier for the contact person

Response

ContactPerson Entity

Error

Error Schema

Example Usage

curl -X PATCH "https://integration-api.ram.syniotec.com/master-data/v1/contract-management/contracts/123e4567-e89b-12d3-a456-426614174000/contact-persons/98765432-abcd-efgh-ijkl-123456789012" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Doe",
    "isMain": true
  }'