Folders

Folder related APIs

Create Folder

post

Authorizations

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

namestring · max: 50Required

parentFolderIdany ofOptional

stringOptional

or

nullOptional

followParentFolderPermissionany ofOptionalDefault: false

booleanOptional

or

nullOptional

permissionGroupEditorsany ofOptional

or

nullOptional

permissionGroupViewersany ofOptional

or

nullOptional

agentEditorsany ofOptional

string[]Optional

or

nullOptional

agentViewersany ofOptional

string[]Optional

or

nullOptional

userViewersany ofOptional

or

nullOptional

allowOtherAgentsViewbooleanOptionalDefault: true

allowOtherUsersViewbooleanOptionalDefault: true

Responses

200

OK

application/json

post

HTTPcURLJavaScriptPython

POST /webapi/v2/folders HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 302

{
  "name": "text",
  "parentFolderId": "text",
  "followParentFolderPermission": false,
  "permissionGroupEditors": [],
  "permissionGroupViewers": [],
  "agentEditors": [
    "text"
  ],
  "agentViewers": [
    "text"
  ],
  "userViewers": {
    "customerIds": [
      "text"
    ],
    "customerGroupIds": [
      "text"
    ]
  },
  "allowOtherAgentsView": true,
  "allowOtherUsersView": true
}

200

OK

{
  "id": "text",
  "name": "text",
  "createdAt": 1,
  "updatedAt": 1,
  "parentFolderId": "text"
}

Update Folder

put

Authorizations

Path parameters

folder_idstringRequired

Header parameters

AGENT-EMAILstringOptional

Optional: Email of the agent to use for this request

USER-EMAILstringOptional

Optional: Email address to associate with the user

OWN-USER-IDstringOptional

Optional: User ID to identify or create a user

Body

namestring · max: 50Required

permissionGroupEditorsany ofOptional

or

nullOptional

permissionGroupViewersany ofOptional

or

nullOptional

agentEditorsany ofOptional

string[]Optional

or

nullOptional

agentViewersany ofOptional

string[]Optional

or

nullOptional

userViewersany ofOptional

or

nullOptional

allowOtherAgentsViewbooleanOptionalDefault: true

allowOtherUsersViewbooleanOptionalDefault: true

Responses

200

OK

application/json

put

HTTPcURLJavaScriptPython

PUT /webapi/v2/folders/{folder_id} HTTP/1.1
Host: backend.alli.ai
API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 241

{
  "name": "text",
  "permissionGroupEditors": [],
  "permissionGroupViewers": [],
  "agentEditors": [
    "text"
  ],
  "agentViewers": [
    "text"
  ],
  "userViewers": {
    "customerIds": [
      "text"
    ],
    "customerGroupIds": [
      "text"
    ]
  },
  "allowOtherAgentsView": true,
  "allowOtherUsersView": true
}

200

OK

{
  "id": "text",
  "name": "text",
  "createdAt": 1,
  "updatedAt": 1,
  "parentFolderId": "text"
}