Skip to main content
POST
List tools

Authorizations

x-access-token
string
header
required

JWT token passed in x-access-token header

Body

application/json
minimum
boolean

When true, returns a lightweight list (name, _id, status, description, rtEnabled, rtOnly, categories) with NO pagination. Used by RT dropdown selectors. Available to all authenticated users; full mode requires super admin.

institution
string

Minimum mode only. Institution to compute Google-service availability for — rows gain unavailable/unavailableReason/locked based on that institution's Google Cloud configuration (used by the instance editor's Connector MCP and Tools tab). Super admins may target any institution; other callers are limited to their own.

page
integer
default:1

Page number (1-based, ignored when minimum=true)

Required range: x >= 1
pageSize
integer
default:100

Number of results per page (ignored when minimum=true)

Required range: 1 <= x <= 5000

Response

Tool list retrieved successfully

success
boolean
data
object[]

Array of tools (sorted by name asc). Excludes deleted status; minimum mode also excludes inactive.

total
integer

Total number of matching tools (omitted when minimum=true)

hasMore
boolean

Whether more pages remain (omitted when minimum=true)

page
integer

Current page number (omitted when minimum=true)

pageSize
integer

Page size used (omitted when minimum=true)

message
string