GET
Get Schema
Return the extraction field schemas for one or more workflows. When more than one workflow_id is supplied, the response also includes shared_fields — the intersection of field names present on every workflow in the request. GET /api/v1/analytics/post-call-variables/schema Use this endpoint to populate the field picker in an extraction chart builder — it’s the source of truth for which fields are chartable per workflow, and which are safe to chart across workflows.

Query parameters

string
required
Comma-separated list of workflow ids the caller owns. Non-integer entries return 400; an id from another organization returns 404.

Response

string
"single" when exactly one workflow_id was supplied, otherwise "cross".
array
One entry per requested workflow.
array | null
The cross-workflow intersection. null (or omitted) in single mode; always an array (possibly empty) in cross mode.

Cross-workflow mode

When you pass more than one workflow_id, the response describes both the per-workflow fields and the compatible set for cross-workflow charts. See Overview → Single vs. cross-workflow mode for the five common use cases (agent versions, regional variants, A/B, portfolio, drift monitoring). The matching algorithm is spec’d in openspec/changes/post-call-variable-charts/design.md §D3:
  1. Intersect field name sets across all requested workflows.
  2. Drop names whose type is not the same on every workflow.
  3. For selector fields, take the intersection of options across all workflows; drop the field if the intersection is empty.

Example — single workflow

cURL
Response

Example — cross-workflow

cURL
Response

Errors

Authorizations

Authorization
string
header
required

Interactive user session: the login JWT, sent as Authorization: Bearer <token>.

Query Parameters

workflow_ids
string
required

Comma-separated workflow ids

Response

Successful Response

mode
enum<string>
required
Available options:
single,
cross
workflows
WorkflowFields · object[]
required
text_word_frequency
boolean
default:true
shared_fields
SharedField · object[] | null