Skip to main content
GET
/
v1
/
files
/
tags
cURL
curl --request GET \
  --url https://api.botpress.cloud/v1/files/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'x-bot-id: <x-bot-id>'
{
  "tags": [
    "<string>"
  ],
  "meta": {
    "nextToken": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://botpress.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
x-bot-id
string
required

Bot id

​
x-integration-id
string

Integration id

​
x-integration-alias
string

Integration alias

​
x-integration-name
string

Integration name

​
x-user-id
string

User Id

​
x-user-role
string

User Role

Query Parameters

​
nextToken
string

Provide the meta.nextToken value provided in the last API response to retrieve the next page of results

Response

Returns the list of available tags used across all files of the bot.

​
tags
string[]
required
​
meta
object
required
Last modified on March 20, 2026