Get available tools for the authenticated user

Retrieves the list of active tools available for the current user. Returns minimal tool information needed for Pria requests, including availability status for Google-integrated tools based on the user’s institution settings and Google Cloud configuration.

Results are sorted in ascending alphabetical order by tool name.

For Google-integrated tools (gmail, drive, calendar, sheets, docs, slides, meet, maps, classroom), the response includes unavailable and unavailableReason fields. Availability is determined by checking whether Google OAuth is configured, whether the institution has enabled Google Cloud for users, and whether an institution-level Google account is connected. Non-Google tools do not include these fields.

POST /api/user/tools

Get available tools for the authenticated user

cURL

curl --request POST \
  --url https://pria.praxislxp.com/api/user/tools \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "minimum": true
}
'

200

withTools

{ "success": true, "data": [ { "_id": "6631915765bb0a94cfd6ca99", "name": "call_google_calendar", "status": "active", "description": "Access Google Calendar to manage events", "rtEnabled": true, "rtOnly": false, "unavailable": false, "unavailableReason": "" }, { "_id": "6631915765bb0a94cfd6ca9a", "name": "call_google_drive", "status": "active", "description": "Access Google Drive files", "rtEnabled": false, "rtOnly": false, "unavailable": true, "unavailableReason": "Google Cloud not enabled for users" }, { "_id": "6631915765bb0a94cfd6ca9b", "name": "call_web_search", "status": "active", "description": "Search the web", "rtEnabled": false, "rtOnly": false } ] }

Authorizations

x-access-token · string · header · required

JWT token passed in x-access-token header

Body

application/json

minimum · boolean

When true, omits the instructions field from each tool in the response. Useful for selector UIs that only need the identifier + short description.

Example:

true

Response

200

application/json

Tools retrieved successfully

success · boolean · required

Whether the operation was successful

Example:

true

data · object[] · required

List of tools sorted in ascending order by name

Show child attributes

message · string

Present only when no tools are found, with the value "No Tools"

Example:

"No Tools"