Skip to main content
POST
Assign to agents
Adds or removes assignments between agents and attributes. Send a batch of junction changes in one request. An attribute only runs in conversations for agents it is assigned to.

Headers

string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
string
required
application/json

Body parameters

Junction[]
required
Array of junction changes to apply.
string
required
Agent ID.
string
required
Attribute ID.
string
required
ADD to create the assignment, DELETE to remove it.
string[]
Optional channels the assignment applies to, for example chat and email.

Response

Returns { "success": true } when the changes are applied.

Errors

The body is malformed, or a junction is missing botId, toolId, or a valid action.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope required for this route.