Create conversation
Create a new AI-powered conversation.
Impersonation:
- When using impersonation, the conversation is created as the impersonated user
Authorizations
Use Authorization: Bearer
Headers
Email of the user to impersonate. Requires CAN_IMPERSONATE_OTHER_USERS permission.
If the target user is not found or does not have access to the project, the request
proceeds as the authenticated user. Contact Clarifeye to enable this permission.
Path Parameters
UUID of the project
Body
ID of the agent settings to use
Conversation name (auto-generated if not provided)
"Analysis Session"
Conversation type
Tags for organizing conversations
Custom instructions for this conversation
"Focus on financial data extraction"
Response
Conversation created successfully
ID of the user who created the conversation
Whether the conversation is shared with all workspace members
Whether the current user can send messages to this conversation. For shared conversations, only the creator and admins can send messages.
Whether the conversation has been soft-archived
Timestamp when the conversation was archived, null if not archived