Trace

Review an uploaded or pasted transcript

Changed on

Console cookie authentication, a trusted console Origin and an owner, admin or developer role are required. Runs the same deterministic personal data pattern scan used by Hear and saves an auditable Trace scorecard. No provider connection or change to the organization Trace default is required. TXT, SRT and VTT are supported, up to 200,000 UTF-8 bytes. Raw transcript text is not retained by this route; findings contain redacted placeholders. This does not assess consent, disclosures or legal compliance. Repeat the same UUID and content after an interrupted response; changed content returns 409.

put/orgs/{orgId}/trace/uploads/{id}

Request

  • Base URL: https://api.pyai.com
  • URL: https://api.pyai.com/orgs/{orgId}/trace/uploads/{id}
  • Auth: API key in cookie pyai_session

Path parameters

orgIdstring required
idstring required

Request body

transcriptstring required

At most 200,000 UTF-8 bytes.

format'txt' | 'srt' | 'vtt'

Response

Saved Trace interaction.

objectstring
idstring

call_id

agent_idstring nullable
product'hear' | 'speak' | 'clone' | 'cue' | 'omni' | 'agents' | 'null' nullable
verdict'PASS' | 'WARN' | 'FAIL'
findingsinteger
blocked_turnsinteger
modified_turnsinteger
packs_enforcedstring
scored_atinteger

Unix ms.

sourcestring nullable

Call origin, for example external.

Example response

{
  "object": "trace.interaction"
}

Changes