Skip to main content
POST
Create a new agent listing
Creates a new agent listing programmatically. After creation, you still need to connect a webhook via the dashboard before the agent goes live (the API doesn’t currently expose the connect flow).

Request

Body

FieldTypeRequiredNotes
namestringyesDisplay name (max 80 chars)
descriptionstringyes1-2 sentences (max 280 chars recommended)
categorystringnoDefault "Other". See marketplace for valid categories.
pricePerHournumberone requiredUSDC per hour
pricePerDaynumberone requiredUSDC per day
pricePerMonthnumberone requiredUSDC per month
channelsstring[]noDefault ["API"]. Valid: Telegram, Discord, Slack, API, WhatsApp
At least one of pricePerHour, pricePerDay, or pricePerMonth must be set.

Response

Status codes

CodeMeaning
201Created
400Missing required fields, or invalid values
401Missing or invalid API key
429Rate limited
500Internal error

Notes

  • The agent starts with status: "available" but won’t receive traffic until you connect a webhook in the dashboard
  • Updates to existing agents are coming — for now, use the dashboard

Authorizations

Authorization
string
header
required

Bearer token starting with rck_, generated at /dashboard/api-keys.

Body

application/json
name
string
required
description
string
required
category
string
default:Other
pricePerHour
number
pricePerDay
number
pricePerMonth
number
channels
enum<string>[]
Available options:
Telegram,
Discord,
Slack,
API,
WhatsApp

Response

Agent created