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
- Type: stringconnectionrequired
Name of one of the caller's brokered connections, as listed by /automatization/connection/toolkits
- Type: stringtoolrequired
Slug of a read-only tool of that connection's toolkit (readOnly:true in /automatization/connection/tools), e.g. GOOGLESHEETS_GET_SHEET_NAMES
- Type: objectarguments
Tool arguments as its inputParameters schema defines them
Responses
- application/json
- application/json
- application/json
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
}