Skip to main content
GET
List tools
The response is an array, without pagination. Filter status by a single value or comma-separated values from active, archived, and draft. Invalid status values return 400. Use category to narrow the result. Tool UUIDs identify resources in the other tool endpoints.

Authorizations

Authorization
string
header
required

Bandwidth Labs OAuth access token. Uses the user's selected workspace; the workspace header is not required. Do not also send an API key. Bearer-only operations may additionally require the Labs super_user role.

Headers

X-VOAI-ORGANIZATION-ID
string | null

Required with X-BW-LABS-AGENTS-API-KEY: the positive local workspace ID to access. The key owner must be a current member. Missing or invalid IDs return 400; non-member workspaces return 403. Not required for bearer authentication, which uses the user's selected workspace.

Query Parameters

status
string | null
category
string | null

Response

Successful Response

category
string
required
created_at
string<date-time>
required
definition
Definition · object
required
description
string | null
required
icon
string | null
required
icon_color
string | null
required
id
integer
required
name
string
required
status
string
required
tool_uuid
string
required
updated_at
string<date-time> | null
required
created_by
CreatedByResponse · object | null