Skip to main content
GET
Get Policy Email Conversation

Authorizations

Authorization
string
header
required

User-principal OAuth 2.0 Bearer authentication. Send a user-scoped Auth0 access token (audience = the app API audience) as Authorization: Bearer <jwt>. The request resolves to the user's identity and is authorized by their Role on the {companyId} in the path — the same role-based permissions the web app enforces. This is the path the MCP connector uses to act on a user's behalf; endpoints that accept it list both BearerAuth and ApiKeyAuth.

Path Parameters

companyId
string<uuid>
required

Company identifier

policyId
string<uuid>
required

Policy identifier

threadId
string<uuid>
required

The conversation's threadId, from List Record Email Conversations.

Response

The conversation

One conversation on a record, every message the caller may see, oldest first.

threadId
string<uuid>
required
subject
string
required
mentionsRecord
boolean
required

A message names the record's number. For an exposure, person or organization, which have no number, a message names any record.

mentions
object[]
required

The other records the conversation's messages name, by type, then label. The record itself is left out.

messages
object[]
required