FruxonDocs
Agent NetworkSlots

Binds a declared slot to a participant, a roster role, or the operator queue

The body's `bindingType` chooses how the slot is fulfilled: `PARTICIPANT` names one person, `ROLE` defers to whoever holds that roster role in this Application (the same selection `consult_for_role` uses, so notify and consult cannot reach different people), and `QUEUE` routes to the awaiting-human queue. Re-binding replaces the binding in place; the binding id is preserved so audit references stay correlatable. A binding decides who is delivered to. It never grants anyone the right to answer or act; that is checked separately when an answer arrives.

PUT
/v1/tenants/{tenant}/agents/{agent}/slots/{slot}/binding

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The agent identifier.

slot*string

The declared slot name.

tenant*string

The tenant identifier

Request Body

The binding target.

bindingType?string

How the slot should be fulfilled. Required.

Value in"UNSPECIFIED" | "PARTICIPANT" | "ROLE" | "QUEUE"
participantId?string|null

The participant to bind — required for SlotBindingType.Participant.

Formatuuid
role?string|null

The roster role to defer to — required for SlotBindingType.Role.

[key: string]?never

Response Body

curl -X PUT "https://api.fruxon.com/v1/tenants/string/agents/string/slots/string/binding" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "agentId": "string",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "agentMembershipId": "00000000-0000-0000-0000-000000000000",
  "slotName": "string",
  "bindingType": "PARTICIPANT",
  "participantId": "00000000-0000-0000-0000-000000000000",
  "roleRef": "string",
  "boundParticipantId": null,
  "createdAt": 0,
  "modifiedAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Removes the slot's binding

Returns 204 whether or not a binding existed. The slot declaration on the revision is untouched; only the participant wiring is removed.

Lists every channel binding wired to the agent.

Returns all `AgentChannelBinding` rows for the agent, in both directions. Bindings stand alone (no per-revision slot to join against), so the response is a flat list ordered by creation time.