Skip to main content
PATCH
Update person reference

Authorizations

Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Path Parameters

id
string
required

Person UUID

reference_id
string
required

Reference UUID

Body

application/json
reference_type
string

New reference type key. List the keys for your workspace with GET /v1/persons/reference-types.

Minimum string length: 1
reference_strength
enum<string> | null

How strong the relationship is: "low", "medium" or "high". Pass null to clear it.

Available options:
low,
medium,
high
note
string | null

Note about the reference, such as what a reference said. Accepts plain text or HTML (bold, italics, lists, links and headings keep their formatting). Pass null to remove the note.

occurred_at
string<date-time>

ISO 8601 timestamp for when the reference actually happened (e.g. "2024-01-10T14:00:00Z"). This is distinct from created_at, which is a system-managed timestamp for when the reference was written and cannot be changed. Omit to leave the existing time unchanged.

Response

Reference updated

success
enum<boolean>
required
Available options:
true
data
object
required