Developers

Authentication

Send your secret key in the X-API-Key header. Keys are shown once at creation — store them securely.

curl -X GET "https://tool-verse.online/api/v1/tools/" \
  -H "X-API-Key: tv_live_…" \
  -H "Accept: application/json"

Rate limits

• Default: 60 requests per minute per key (configurable).
• Monthly quota defaults to 10,000 units per key.
• 429 responses mean you should back off and retry.

Useful endpoints

• GET https://tool-verse.online/api/v1/tools/
• GET https://tool-verse.online/api/v1/tools/{slug}/
• POST https://tool-verse.online/api/v1/t/dynamic/{slug}/run/
• POST https://tool-verse.online/api/v1/jobs/
• GET https://tool-verse.online/api/v1/jobs/{id}/

OpenAPI

Download the machine-readable schema for code generation and Enterprise integrations.

TypeScript SDK

Use the workspace package @toolverse/api-client for marketplace and mobile endpoints. Regenerate the stub with manage.py generate_sdk.

npm install @toolverse/api-client

import { ToolVerseApiClient } from "@toolverse/api-client";

const client = new ToolVerseApiClient({
  apiKey: process.env.TOOLVERSE_API_KEY!,
  clientPlatform: "web",
});

const tools = await client.listTools({ compact: true });

Usage billing stubs

Monthly invoice drafts are generated from API usage aggregates. They stay draft until you reconcile billing externally.

• GET /marketplace/invoices/ — draft ApiInvoiceStub rows from usage
• GET /marketplace/analytics/ — daily usage and per-key breakdown

Enterprise

Developer organizations, usage analytics, and invoice stubs for billed API access. Create an org from your account API or contact sales for Enterprise tier.

• GET /marketplace/analytics/ — daily usage time-series
• GET/POST /marketplace/orgs/ — manage developer organizations