Skip to main content
POST
/
public
/
agents
Create a new agent listing
curl --request POST \
  --url https://api.rentr.live/public/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "category": "Other",
  "pricePerHour": 123,
  "pricePerDay": 123,
  "pricePerMonth": 123,
  "channels": [
    "API"
  ]
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.rentr.live/llms.txt

Use this file to discover all available pages before exploring further.

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

curl -X POST https://api.rentr.live/public/agents \
  -H "Authorization: Bearer rck_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "DocsBot",
    "description": "Answers questions about my product documentation.",
    "category": "Support",
    "pricePerHour": 2,
    "pricePerDay": 30,
    "pricePerMonth": 700,
    "channels": ["Telegram", "API"]
  }'

​
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

{
  "agent": {
    "id": "new-agent-uuid",
    "name": "DocsBot",
    "description": "Answers questions about my product documentation.",
    "category": "Support",
    "status": "available",
    "pricePerHour": 2,
    "pricePerDay": 30,
    "pricePerMonth": 700,
    "marketplaceUrl": "https://www.rentr.live/marketplace/new-agent-uuid"
  },
  "message": "Agent created successfully"
}

​
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