curl --request PUT \
  --url https://api.sandbox.paypathiq.com/v1/clients/{clientCode}/parties/{externalPartyId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": {
    "firstName": "Avery",
    "lastName": "Example"
  },
  "type": "person"
}
'

{
  "addresses": [
    {
      "countryCode": "IE",
      "isPrimary": true,
      "line1": "1 Example Street",
      "line2": "Example Building",
      "locality": "Dublin",
      "postalCode": "D02 X285",
      "region": "Dublin",
      "type": "home"
    }
  ],
  "emails": [
    {
      "address": "avery@example.test",
      "isPrimary": true,
      "type": "personal"
    }
  ],
  "name": {
    "firstName": "Avery",
    "lastName": "Example"
  },
  "phones": [
    {
      "isPrimary": true,
      "number": "+35315550123",
      "type": "mobile"
    }
  ],
  "sourceReference": "member-ref-example",
  "type": "person",
  "externalPartyId": "PTY_123",
  "updatedAt": "2026-08-29T12:00:00Z"
}

{
  "addresses": [
    {
      "countryCode": "IE",
      "isPrimary": true,
      "line1": "1 Example Street",
      "line2": "Example Building",
      "locality": "Dublin",
      "postalCode": "D02 X285",
      "region": "Dublin",
      "type": "home"
    }
  ],
  "emails": [
    {
      "address": "avery@example.test",
      "isPrimary": true,
      "type": "personal"
    }
  ],
  "name": {
    "firstName": "Avery",
    "lastName": "Example"
  },
  "phones": [
    {
      "isPrimary": true,
      "number": "+35315550123",
      "type": "mobile"
    }
  ],
  "sourceReference": "member-ref-example",
  "type": "person",
  "externalPartyId": "PTY_123",
  "updatedAt": "2026-08-29T12:00:00Z"
}

{
  "detail": "Request body is not valid JSON.",
  "errors": [
    {
      "code": "malformed_json",
      "detail": "Request body is not valid JSON.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 400,
  "title": "Request body is not valid JSON.",
  "type": "https://docs.paypathiq.com/problems/malformed_json"
}

{
  "detail": "API key is invalid, inactive, revoked, or for another environment.",
  "errors": [
    {
      "code": "invalid_api_key",
      "detail": "API key is invalid, inactive, revoked, or for another environment.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 401,
  "title": "API key is invalid, inactive, revoked, or for another environment.",
  "type": "https://docs.paypathiq.com/problems/invalid_api_key"
}

{
  "detail": "Client or Integration grant scope is denied.",
  "errors": [
    {
      "code": "client_scope_denied",
      "detail": "Client or Integration grant scope is denied.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 403,
  "title": "Client or Integration grant scope is denied.",
  "type": "https://docs.paypathiq.com/problems/client_scope_denied"
}

{
  "detail": "Request body exceeds the 256 KiB limit.",
  "errors": [
    {
      "code": "request_too_large",
      "detail": "Request body exceeds the 256 KiB limit.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 413,
  "title": "Request body exceeds the 256 KiB limit.",
  "type": "https://docs.paypathiq.com/problems/request_too_large"
}

{
  "detail": "Media type or content encoding is unsupported.",
  "errors": [
    {
      "code": "unsupported_media_type",
      "detail": "Media type or content encoding is unsupported.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 415,
  "title": "Media type or content encoding is unsupported.",
  "type": "https://docs.paypathiq.com/problems/unsupported_media_type"
}

{
  "detail": "Request parameters or representation are invalid.",
  "errors": [
    {
      "code": "validation_error",
      "detail": "Request parameters or representation are invalid.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 422,
  "title": "Request parameters or representation are invalid.",
  "type": "https://docs.paypathiq.com/problems/validation_error"
}

{
  "detail": "The Integration has exceeded its current request limit.",
  "errors": [
    {
      "code": "rate_limit_exceeded",
      "detail": "The Integration has exceeded its current request limit.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 429,
  "title": "The Integration has exceeded its current request limit.",
  "type": "https://docs.paypathiq.com/problems/rate_limit_exceeded"
}

{
  "detail": "An unexpected retryable error prevented a safe commit.",
  "errors": [
    {
      "code": "internal_error",
      "detail": "An unexpected retryable error prevented a safe commit.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 500,
  "title": "An unexpected retryable error prevented a safe commit.",
  "type": "https://docs.paypathiq.com/problems/internal_error"
}

{
  "detail": "The record could not be projected safely in this transaction.",
  "errors": [
    {
      "code": "projection_unavailable",
      "detail": "The record could not be projected safely in this transaction.",
      "pointer": "/"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 503,
  "title": "The record could not be projected safely in this transaction.",
  "type": "https://docs.paypathiq.com/problems/projection_unavailable"
}