Skip to main content
GET
Get Record 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

entityType
enum<string>
required

Field Model V1 entity type (lowercase kebab-case URL slug). One of the six CRUD entity types: event, exposure, quote, submission, person, organization. policy is NOT valid here — Policy has no generic CRUD (its writes go through the policy transaction endpoints), though it does have a read-only /configuration schema.

Available options:
event,
exposure,
quote,
submission,
person,
organization
entityId
string<uuid>
required

Entity 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