Run a read-only tool through a Composio-backed connection to see real data

​

For designing an automation: shows what a tool really returns for the caller's own connection (sheet names, a header row) without writing and running a script. Takes the same body as /automatization/connection/call and answers the same way, with two differences. Only read-only tools run: Boost.space reads the tool's metadata from the provider and refuses anything not tagged read-only, or whose metadata it cannot read, with 4265 (HTTP 403) - no tool that writes is ever executed here. And data is cut to about 16 KB, keeping its structure (lists to their first items, long strings shortened), with truncated:true when anything was cut. Errors ({code, message}) are otherwise those of call: 4260 (HTTP 404) no brokered connection of that name for the caller; 4261 (HTTP 403) tool outside the connection's toolkit; 4262 (HTTP 403) not configured on this instance, or the provider refused its key; 4263 (HTTP 502) provider unreachable, safe to retry; 4015/4017 (HTTP 400) missing or malformed input; 4266 (HTTP 429) over the caller's budget of 60 requests per fixed 60-second window, shared by tools, tool detail, inspect and status - retry after the Retry-After header. A result too large to read (over 2 MB) comes back as data null with truncated true.

Body

required
application/json
  • Name of one of the caller's brokered connections, as listed by /automatization/connection/toolkits

  • Slug of a read-only tool of that connection's toolkit (readOnly:true in /automatization/connection/tools), e.g. GOOGLESHEETS_GET_SHEET_NAMES

  • Tool arguments as its inputParameters schema defines them

Responses

  • application/json
  • application/json
  • application/json
Request Example for post/automatization/connection/inspect
curl https://test.boost.space/api/automatization/connection/inspect \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "connection": "",
  "tool": "",
  "arguments": {}
}'
{
  "successful": true,
  "data": null,
  "error": null,
  "truncated": true
}