Skip to main content
GET
Get Surface Provenance

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Authorization
string
header
required

This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the c1TokenSource.Token() function.

Path Parameters

conversation_id
string
required

The conversationId field.

surface_id
string
required

The surfaceId field.

Response

200 - application/json

A2UIServiceGetSurfaceProvenanceResponse returns the surface's sources with verification verdicts plus the transcript tool calls they were checked against.

A2UIServiceGetSurfaceProvenanceResponse returns the surface's sources with verification verdicts plus the transcript tool calls they were checked against.

programCommitId
string

The program's identity: code mode invokes by explicit commit, so the commit — not the function — is what a refresh re-executes.

programFunctionId
string

The program that produced a reporting surface. Flat rather than a nested ref: these five fields are read together by one drawer and nothing else, and a saved report's ProgramRef is the type worth converging on later. All empty for a surface carrying no report components, and for reports emitted before the report-program requirement was enabled for the tenant.

programInput
string

The JSON parameters the program ran with. Empty when the invocation has aged out of retention.

programInvocationId
string

The run that produced this surface.

programSource
string

The program's source, read from the pinned commit. Empty when the commit has aged out of code-mode retention — the report still renders, but what produced it is no longer recoverable.

sources
A 2 Ui Provenance Source · object[] | null

The sources field.

toolCalls
A 2 Ui Provenance Tool Call · object[] | null

The toolCalls field.

transcriptAvailable
boolean

False when the backing session or its transcript steps are gone; sources are then all unverified.