Appearance
lubb-force
10 endpoints.
GET /api/v1/lubb-force/channel/handoffs
List Channel Handoffs
A system sees only the hand-offs it sent: Lubb Desk by conversation, Lubb Team by the mailbox that asked (requester).
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
status | query | no | ||
to | query | no | ||
account_id | query | no | ||
conversation_id | query | no | ||
requester | query | no | ||
limit | query | no | integer | |
x-lubb-force-secret | header | no |
200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response List Channel Handoffs Api V1 Lubb Force Channel Handoffs Get"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}POST /api/v1/lubb-force/channel/handoffs
Post Handoff
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
x-lubb-force-secret | header | no |
Request body
json
{
"type": "object",
"additionalProperties": true,
"title": "Payload"
}200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Post Handoff Api V1 Lubb Force Channel Handoffs Post"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}POST /api/v1/lubb-force/channel/handoffs/resolved
Resolved Conversation
Lubb Desk resolved a conversation: its hand-offs come off the channel (channel.remove_for_resolved). Declared before /{handoff_id} so "resolved" is not read as an id.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
x-lubb-force-secret | header | no |
Request body
json
{
"type": "object",
"additionalProperties": true,
"title": "Payload"
}200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Resolved Conversation Api V1 Lubb Force Channel Handoffs Resolved Post"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}POST /api/v1/lubb-force/channel/handoffs/answered
Answered Conversation
A person replied to the customer in a Lubb Desk conversation: its active hand-offs are done (channel.close_for_answered).
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
x-lubb-force-secret | header | no |
Request body
json
{
"type": "object",
"additionalProperties": true,
"title": "Payload"
}200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Answered Conversation Api V1 Lubb Force Channel Handoffs Answered Post"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}GET /api/v1/lubb-force/channel/handoffs/{handoff_id}
Get Channel Handoff
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
handoff_id | path | yes | integer | |
x-lubb-force-secret | header | no |
200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Get Channel Handoff Api V1 Lubb Force Channel Handoffs Handoff Id Get"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}POST /api/v1/lubb-force/channel/handoffs/{handoff_id}
Update Channel Handoff
The sending system adds a note (more from the customer), closes it, or sends a chat message that wakes the agent to answer (Lubb Desk's Lubb Force tab, owner 2026-10-05: "lubb force tab must be a chat conversation").
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
handoff_id | path | yes | integer | |
x-lubb-force-secret | header | no |
Request body
json
{
"type": "object",
"additionalProperties": true,
"title": "Payload"
}200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Update Channel Handoff Api V1 Lubb Force Channel Handoffs Handoff Id Post"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}GET /api/v1/lubb-force/feed
Feed
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
status | query | no | ||
to | query | no | ||
system | query | no | ||
limit | query | no | integer |
200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Feed Api V1 Lubb Force Feed Get"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}POST /api/v1/lubb-force/feed
Feed Post
Request body
json
{
"type": "object",
"additionalProperties": true,
"title": "Payload"
}200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Feed Post Api V1 Lubb Force Feed Post"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}GET /api/v1/lubb-force/feed/{handoff_id}
Feed Item
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
handoff_id | path | yes | integer |
200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Feed Item Api V1 Lubb Force Feed Handoff Id Get"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}POST /api/v1/lubb-force/feed/{handoff_id}
Feed Update
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
handoff_id | path | yes | integer |
Request body
json
{
"type": "object",
"additionalProperties": true,
"title": "Payload"
}200 — Successful Response
json
{
"type": "object",
"additionalProperties": true,
"title": "Response Feed Update Api V1 Lubb Force Feed Handoff Id Post"
}422 — Validation Error
json
{
"properties": {
"detail": {
"items": {
"properties": {
"loc": {
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "integer"
}
]
},
"type": "array",
"title": "Location"
},
"msg": {
"type": "string",
"title": "Message"
},
"type": {
"type": "string",
"title": "Error Type"
}
},
"type": "object",
"required": [
"loc",
"msg",
"type"
],
"title": "ValidationError"
},
"type": "array",
"title": "Detail"
}
},
"type": "object",
"title": "HTTPValidationError"
}