Skip to main content
A Participant represents any individual whose performance or results are tracked across transcriptions — a support agent, salesperson, job candidate being interviewed, or any other person. Participants are optional — use them when you need per-person analytics.

​
Fields

FieldTypeRequiredDescription
participant_idstringAuto-generatedUnique identifier (UUID)
tagstringYesName or identifier of the participant (e.g. agent name, candidate name, employee ID) — 1–100 chars, whitespace auto-trimmed
metadataobjectNoFree-form key-value pairs for any additional data — max 10 keys, key ≤50 chars, value ≤250 chars
created_atstringAuto-generatedISO 8601 creation timestamp
updated_atstringAuto-updatedISO 8601 last-modified timestamp
All metadata values are stored as strings regardless of the type provided (e.g. 42 → "42", true → "True").
When updating metadata, the new object fully replaces the previous one (PUT semantics). To update a single key without losing the rest, fetch the participant first, modify the object locally, and send the complete updated metadata.

​
Example

{
  "participant_id": "c3d4e5f6-a7b8-9012-3456-789012cdef01",
  "tag": "Sarah Johnson",
  "metadata": {
    "email": "sarah.johnson@example.com",
    "role": "Senior Support Agent",
    "department": "Customer Success",
    "employee_id": "EMP-0042"
  },
  "created_at": "2025-01-15T10:00:00.000000+00:00",
  "updated_at": "2025-01-15T10:00:00.000000+00:00"
}