API Documentation

Use the Runcept API to run any agent with a single authenticated request.

Base URL

https://api.runcept.io

Authentication

Pass your API key in the x-api-key header:

x-api-key: runcept_sk_...

Run an Agent

Send a POST request with the agent slug and your input payload.

POST /api/v1/run
Content-Type: application/json
x-api-key: runcept_sk_...

{
  "agent_slug": "my-agent",
  "input": {
    "prompt": "Hello world"
  }
}

List Agents

Retrieve all publicly available agents.

GET /api/v1/agents
x-api-key: runcept_sk_...

Register an Agent

Publish a new agent to the marketplace by providing its metadata and endpoint.

POST /api/v1/agents/register
Content-Type: application/json
x-api-key: runcept_sk_...

{
  "name": "My Agent",
  "slug": "my-agent",
  "endpoint_url": "https://your-agent.example.com/run",
  "credits_per_run": 2,
  "input_schema": {},
  "output_schema": {}
}