Update entity personnel

PUT

https://api.sureshake.com/v2/entities/{id}/personnel/{personnelId}

Path parameters

id
string
required
format: uuid

personnelId
string
required
format: uuid

Request body JSON

title
optional
string
maxLength: 255 · minLength: 1
role
optional
CEO
or
CFO
or
CTO
or
President
or
VP
or
Director
+3 more
department
optional
string
status
optional
active
or
inactive
or
terminated
isKeyPerson
optional
boolean
startDate
optional
string
endDate
optional
string
notes
optional
string

Returns

200

Default Response

JSON

id
string
required
format: uuid
entityId
string
required
format: uuid
userId
string
or null
required
externalName
string
or null
required
externalEmail
string
or null
required
externalPhone
string
or null
required
title
string
required
role
string
required
department
string
or null
required
status
string
required
isKeyPerson
boolean
required
startDate
string
required
endDate
string
or null
required
notes
string
or null
required
invitationSent
boolean
required
invitationSentAt
string
or null
required
createdBy
string
required
createdAt
string
required
updatedAt
string
required
deletedAt
string
or null
required
deletedBy
string
or null
required
displayName
string
required
displayEmail
string
or null
required
isActive
boolean
required
isExternal
boolean
required
hasInvitation
boolean
required
hasAccount
boolean
required

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

503

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

curl --request PUT \ --url 'https://api.sureshake.com/v2/entities/<id>/personnel/<personnelId>' \ --header 'Content-Type: application/json' \ --data ' { "title": "string", "role": "CEO", "department": "string", "status": "active", "isKeyPerson": true, "startDate": "string", "endDate": "string", "notes": "string" } '

{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5", "userId": "string", "externalName": "string", "externalEmail": "string", "externalPhone": "string", "title": "string", "role": "string", "department": "string", "status": "string", "isKeyPerson": true, "startDate": "string", "endDate": "string", "notes": "string", "invitationSent": true, "invitationSentAt": "string", "createdBy": "string", "createdAt": "string", "updatedAt": "string", "deletedAt": "string", "deletedBy": "string", "displayName": "string", "displayEmail": "string", "isActive": true, "isExternal": true, "hasInvitation": true, "hasAccount": true }