Skip to main content
POST
Create Direct Conversation
Returns an existing DM between the caller and the target user, or creates one if it does not yet exist. Only one direct conversation can exist per user pair per project — this endpoint is idempotent. Returns 201 when a new conversation was created, 200 when an existing one was found.

Body Parameters

userId
string
required
The ID of the user to start a direct conversation with. Must belong to the same project.

Response

Returns a Conversation object with type: "direct".
Direct conversations cannot be updated or deleted, and members cannot leave them. They persist as long as either user’s account exists.

Error Responses