Home//
- UpdateConversationRequest
GetUserRequest
UpdateUserRequest
CreateUserRequest
GetConversationRequest
CreateConversationRequest
GetMessagesRequest
CreateMessageRequest
WebhookConversationEventRequest
EndUserResponse
AgentsResponse
ConversationResponse
CreateConversationResponse
MessagesResponse
MessageResponse
EndUser
Agent
Conversation
Message
Attachment
ProblemDetails
CustomAttributes
ConversationAttributes
ConversationStatus
MessageType
MessageVisibility
HtmlMessageBody
UserBasic
MessageInput
MessageAuthor
UpdateConversationRequest
attributesobject(ConversationAttributes)
Attributes associated with the conversation
Example:
{ "issue_type": "Billing", "priority": "High" }
statusstring(ConversationStatus)
Current conversation status:
open- Conversation is actively ongoing with the end-userresolved- Conversation is resolved by Finclosed- Conversation is finished/archivedended- Conversation is ended by the end-user or agent
Enum:"open""resolved""closed""ended"
Example:"resolved"
Agent ID (Fin agent). Set to null when handing over to a human agent.
Example:"agent_fin"
When user last read the conversation
Example:"2025-10-27T15:45:00.000Z"
userobject(UserBasic)
Basic user information for requests
{ "conversation_id": "conv_456", "title": "Pricing inquiry - resolved", "tags": [ "pricing", "sales" ], "attributes": { "issue_type": "Billing", "priority": "High" }, "status": "resolved", "assignee_id": "agent_fin", "last_user_read_at": "2025-10-27T15:45:00.000Z", "user": { "id": "user_123456", "name": "Jane Doe", "email": "jane.doe@example.com", "photo_url": "https://example.com/avatars/jane.jpg", "user_type": "end_user", "attributes": { … } } }