API Overview

The ToolPlexer HTTP API lets you discover, inspect, and run tools programmatically.

Base URL

https://api.toolplexer.com

Authentication

All /v1/* endpoints require Bearer authentication:

Authorization: Bearer tpl_live_...

Create a key in the dashboard. The key belongs to one workspace.

Endpoints

Catalog

Method	Path	Description
`POST`	`/v1/discover`	Search for endpoints
`GET`	`/v1/tools`	List the catalog
`POST`	`/v1/inspect`	Get full endpoint details
`POST`	`/v1/run`	Execute a provider endpoint
`POST`	`/v1/execute`	Route a task to a provider

Runs

Method	Path	Description
`GET`	`/v1/runs`	List runs
`GET`	`/v1/runs/get`	Get run status and results
`POST`	`/v1/runs/stop`	Stop a queued run
`POST`	`/v1/runs/feedback`	Rate a run `1`–`5`

Wallet

Method	Path	Description
`GET`	`/v1/balance`	Current balance
`GET`	`/v1/whoami`	Workspace and key
`GET`	`/v1/activities`	Wallet transactions

On-chain payment: Pay with x402.

Request format

JSON bodies with Content-Type: application/json.

curl -X POST https://api.toolplexer.com/v1/discover \
  -H "Authorization: Bearer tpl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"query":"web search"}'

Response format

Successful responses return the resource directly. Errors:

{
  "code": 400,
  "message": "Descriptive error message"
}

Object responses include hints. Every response has an x-request-id header.

Pagination

List endpoints use cursor pagination.

Parameter	Type	Description
`limit`	number	Max items (default and max vary by endpoint)
`cursor`	string	Opaque cursor from a previous response

{
  "items": [],
  "nextCursor": "1788724875390:…"
}

If nextCursor is null or absent, you are on the last page.

Error codes

Code	Meaning
`202`	Accepted — the run is async. Poll `GET /v1/runs/get`.
`400`	Bad request — invalid input or JSON
`401`	Missing or invalid API key
`403`	Not allowed
`404`	Not found
`409`	Conflict — e.g. stopping a run that is not stoppable
`503`	Endpoint unavailable (outage or unconfigured)

Insufficient funds return 200 with status: "BLOCKED" and controls, not 402.

On this page