Assign knowledge to agents

curl --request POST \
  --url 'https://api-prod.usefini.com/v2/hc-bot-folder-junctions/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "junctions": [
      {
        "folderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b",
        "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
        "action": "ADD"
      }
    ]
  }'

{
  "status": true
}

POST

hc-bot-folder-junctions

public

curl --request POST \
  --url 'https://api-prod.usefini.com/v2/hc-bot-folder-junctions/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "junctions": [
      {
        "folderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b",
        "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
        "action": "ADD"
      }
    ]
  }'

{
  "status": true
}

Use this route to control which folders, and therefore which knowledge, an agent can access.

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

array

required

Batch of folder-agent changes.

Show junction object

string

required

Folder ID to assign or unassign.

string

required

Agent ID the folder should be changed on.

string

required

Action to apply. Allowed values are ADD and DELETE.

curl --request POST \
  --url 'https://api-prod.usefini.com/v2/hc-bot-folder-junctions/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "junctions": [
      {
        "folderId": "0f4da4fe-b2ae-4787-8c3b-854f36d9eb1b",
        "botId": "4f5ef695-d03b-4d56-8fef-7f2bd5c17ef3",
        "action": "ADD"
      }
    ]
  }'

Response

boolean

Always true when the batch succeeds.

Errors

400 Bad Request

The request body is malformed, or one of the enum values is invalid.

401 Unauthorized

The API key is missing, malformed, revoked, or invalid.

403 Forbidden

The API key does not include the write scope.

⌘I

​Headers

​Body parameters

​Response

​Errors

Headers

Body parameters

Response

Errors