Test Tool | BCTRL Docs

Execute a tool once without starting an agent invocation. Use this to validate the schema, authentication, response shape, and latency.

AuthorizationBearer

Use Bearer <api-key>.

idstringRequired

This endpoint expects an object.

inputanyOptional

recordbooleanOptionalDefaults to true

okboolean

errorstring

errorDetailobject

latencyMsinteger0-9007199254740991

outputany

Any valid JSON value: object, array, string, number, boolean, or null.

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error

$	curl -X POST https://api.bctrl.ai/v1/tools/id/test \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"ok": true,
3	"error": "Tool execution completed successfully.",
4	"errorDetail": {
5	"code": "tool.execution_success",
6	"message": "The tool ran without errors.",
7	"details": {}
8	},
9	"latencyMs": 123,
10	"output": null
11	}