SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
Outreach

Assign a conversation to a member, or pass no user to unassign it

The member must be able to see the inbox.

POSThttps://app.softsolz.uk/api/v1/services/outreach/inbox/conversations/{id}/assign

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

user_idinteger | null

Member to assign it to. Leave out or send null to unassign.

Response

Response Body

conversationobjectThe conversation.

Request

curl --request POST \
--url https://app.softsolz.uk/api/v1/services/outreach/inbox/conversations/{id}/assign \
--header 'Authorization: Bearer sk_live_your_key' \
--header 'Content-Type: application/json' \
--data '{
"user_id": null
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
"data": {
"conversation": {
"id": "311",
"tenant_id": "4c1a7e52-9b3d-4f86-a2e1-7d5c0b9f3e61",
"customer_id": null,
"phone": "+447700900123",
"email": null,
"contact_id": null,
"channel": "sms",
"status": "open",
"assigned_to": null,
"assignee_name": null,
"display_name": "Jane Doe",
"last_inbound_at": "2026-10-01T08:30:00.000Z",
"last_outbound_at": null,
"last_message_at": null,
"last_message_preview": "Is the offer still on?",
"unread_count": 1,
"auto_reply_enabled": true,
"labels": [
"vip"
],
"ai_summary": null,
"ai_intent": null,
"ai_summarised_at": null,
"reply_window_expires_at": null,
"reply_window_open": true,
"created_at": "2026-09-01T09:00:00.000Z",
"updated_at": "2026-09-01T09:00:00.000Z"
}
}
}