Get conversation | Runtype Documentation

{
  "agentMode": "automated",
  "createdAt": "2024-06-10T09:15:00Z",
  "externalParticipantId": "user_987654321",
  "externalThreadId": "thread_123456789",
  "id": "conv_abc123def456",
  "lastMessageAt": "2024-06-12T16:45:00Z",
  "messageCount": 42,
  "participantEmail": "jane.doe@example.com",
  "participantName": "Jane Doe",
  "status": "open",
  "subject": "Issue with account login",
  "surfaceId": "surface_001",
  "takeoverActorId": "agent_12345",
  "takeoverActorType": "human_agent",
  "takeoverAt": "2024-06-12T16:30:00Z",
  "takeoverReason": "complex issue requiring human intervention",
  "timezone": "America/Los_Angeles",
  "updatedAt": "2024-06-12T16:50:00Z",
  "context": {
    "platform": "web",
    "language": "en-US"
  },
  "participantMetadata": {
    "accountType": "premium",
    "region": "us-west"
  },
  "surface": {
    "id": "surface_001",
    "name": "Customer Support Chat",
    "type": "chat"
  }
}

Get a messaging conversation by ID with full details.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Response

Conversation details

agentModestring

createdAtstring

externalParticipantIdstring or null

externalThreadIdstring or null

idstring

lastMessageAtstring or null

messageCountdouble

participantEmailstring or null

participantNamestring or null

statusstring

subjectstring or null

surfaceIdstring

takeoverActorIdstring or null

takeoverActorTypestring or null

takeoverAtstring or null

takeoverReasonstring or null

timezonestring or null

updatedAtstring

contextmap from strings to any

participantMetadatamap from strings to any

surfaceobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

$	curl https://api.runtype.com/v1/messaging/conversations/id \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json"