listFileTags

cURL

curl --request GET \
  --url https://api.botpress.cloud/v1/files/tags \
  --header 'Authorization: Bearer <token>' \
  --header 'x-bot-id: <x-bot-id>'

import requests

url = "https://api.botpress.cloud/v1/files/tags"

headers = {
    "x-bot-id": "<x-bot-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-bot-id': '<x-bot-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.botpress.cloud/v1/files/tags', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.botpress.cloud/v1/files/tags",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "x-bot-id: <x-bot-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.botpress.cloud/v1/files/tags"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-bot-id", "<x-bot-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.botpress.cloud/v1/files/tags")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-bot-id"] = '<x-bot-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "tags": [
    "<string>"
  ],
  "meta": {
    "nextToken": "<string>"
  }
}

{
  "tags": [
    "<string>"
  ],
  "meta": {
    "nextToken": "<string>"
  }
}

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>'

import requests

url = "https://api.botpress.cloud/v1/files/tags"

headers = {
    "x-bot-id": "<x-bot-id>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-bot-id': '<x-bot-id>', Authorization: 'Bearer <token>'}
};

fetch('https://api.botpress.cloud/v1/files/tags', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.botpress.cloud/v1/files/tags",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "x-bot-id: <x-bot-id>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.botpress.cloud/v1/files/tags"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-bot-id", "<x-bot-id>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.botpress.cloud/v1/files/tags")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-bot-id"] = '<x-bot-id>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "tags": [
    "<string>"
  ],
  "meta": {
    "nextToken": "<string>"
  }
}

{
  "tags": [
    "<string>"
  ],
  "meta": {
    "nextToken": "<string>"
  }
}

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

pageSize

integer

Number of items to return per page (default 20, max 100)

Response

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

Get Started

Chat API

Admin API

Files API

Tables API

Runtime API

Authorizations

Headers

Query Parameters

Response