Skip to main content
POST
Assign to agents
Adds or removes assignments between agents and actions. Send a batch of junction changes in one request.

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
Action 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.