Skip to main content
POST
/
v2
/
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

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

​
Body parameters

​
junctions
array
required
Batch of folder-agent changes.
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

​
status
boolean
Always true when the batch succeeds.

​
Errors

The request body is malformed, or one of the enum values is invalid.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope.