Skip to main content
GET
Get a tool
The tool must belong to the requested workspace. Archived tools can still be retrieved. Stored secret values are masked; do not treat masked values as reusable credentials. A missing or inaccessible tool returns 404.

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.

Path Parameters

tool_uuid
string
required

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