Create a direct conversation

POST/direct-conversations

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Body

application/json

workspace_actor_idstring · uuidRequired
An active workspace actor, including your own actor for notes to self. The caller is resolved from authentication.

Responses

201Created · DirectConversationCreates or reopens the unique conversation with this actor, including yourself for private notes.
400Bad requestInactive participant
404Not foundActor is outside the workspace

curl -X POST https://api.fryll.com/direct-conversations \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_actor_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c"
  }'

const res = await fetch(`https://api.fryll.com/direct-conversations`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "workspace_actor_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c"
  }),
});
const data = await res.json();

Response201Created

{
  "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "created_at": "2026-10-14T10:24:03.118Z",
  "updated_at": "2026-10-14T10:24:03.118Z",
  "workspace_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
  "actor_low_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "actor_high_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "last_message_at": "2026-10-14T10:24:03.118Z",
  "unread_message_count": 0,
  "unread_thread_count": 0,
  "has_unread_messages": true
}

Create a direct conversation

POST/direct-conversations

Send Authorization: Bearer <access_token> and X-Workspace-Id.

Body

application/json

workspace_actor_idstring · uuidRequired
An active workspace actor, including your own actor for notes to self. The caller is resolved from authentication.

Responses

201Created · DirectConversationCreates or reopens the unique conversation with this actor, including yourself for private notes.
400Bad requestInactive participant
404Not foundActor is outside the workspace

Plus the usual errors: 403.

curl -X POST https://api.fryll.com/direct-conversations \
  -H "Authorization: Bearer $FRYLL_ACCESS_TOKEN" \
  -H "X-Workspace-Id: $FRYLL_WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_actor_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c"
  }'

const res = await fetch(`https://api.fryll.com/direct-conversations`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.FRYLL_ACCESS_TOKEN}`,
    'X-Workspace-Id': process.env.FRYLL_WORKSPACE_ID!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "workspace_actor_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c"
  }),
});
const data = await res.json();

Response201Created

{
  "id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "created_at": "2026-10-14T10:24:03.118Z",
  "updated_at": "2026-10-14T10:24:03.118Z",
  "workspace_id": "0192f3a4-7b3c-7d2e-9f10-4a5b6c7d8e9f",
  "conversation_id": "0192f3a4-8f22-7a04-b6c5-1d2e3f4a5b6c",
  "actor_low_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "actor_high_id": "0192f3a4-81d0-7c61-a3b2-5e6f7a8b9c0d",
  "last_message_at": "2026-10-14T10:24:03.118Z",
  "unread_message_count": 0,
  "unread_thread_count": 0,
  "has_unread_messages": true
}