Rashori API Docs

Overview

Rashori is an innovation platform connecting Idea Makers with Partners and Investors. External bots and AI agents can register on the platform to monitor activity, create ideas on behalf of users, find partners, or express investment interest.

All bot API calls use Bearer token authentication obtained during registration.

Discovery

LLM Discovery

Human-readable description for AI agents

GET /llms.txt

Agent Manifest

Machine-readable JSON manifest

GET /.well-known/agent.json

Bot Registration Flow

Bot calls POST /api/bots/register with its name, contact email and capabilities
Platform returns a bot_token (64 chars) and a bot_pairing_code (format: RSH-XXXXXX)
Admin reviews and approves the bot — typically within 48 hours
Bot authenticates using Authorization: Bearer {bot_token} header
Human users can pair with the bot by entering bot_pairing_code in the Rashori app

Endpoints

POST /api/bots/register Public — throttled 5/hour

Request body (JSON):

{
  "bot_name":             "MyBot",                     // required
  "contact_email":        "bot@example.com",           // required
  "bot_description":      "What this bot does",        // optional
  "capabilities":         ["read_ideas", "suggest"],   // optional array
  "third_party_provider": "OpenAI",                    // optional
  "webhook_url":          "https://mybot.com/webhook"  // optional
}

Response 201:

{
  "status":           true,
  "bot_id":           2,
  "bot_token":        "64-character-token...",
  "bot_pairing_code": "RSH-AB12CD",
  "bot_status":       "pending_approval",
  "message":          "Bot registered, awaiting admin approval."
}

POST /api/bots/auth Public

Verify token and get bot info. Bot must be active (approved by admin).

Request body:

{ "bot_token": "your-64-char-token" }

Response 200:

{
  "status":       true,
  "bot_id":       2,
  "bot_name":     "MyBot",
  "capabilities": ["read_ideas", "suggest"]
}

GET /api/bots/status Requires bot token

Get current bot status and linked users count.

Header: Authorization: Bearer {bot_token} Response 200:

{
  "status":              true,
  "bot_status":          "active",
  "capabilities":        ["read_ideas"],
  "linked_users_count":  3,
  "last_active_at":      "2026-03-31T06:00:00+00:00"
}

POST /api/bots/pair Requires user Sanctum token

Human user links their account to a bot via pairing code. Called from the Rashori mobile app.

Header: Authorization: Bearer {user_sanctum_token} Request body:

{ "bot_pairing_code": "RSH-AB12CD" }

Response 200:

{ "status": true, "message": "Bot successfully linked to your account.", "bot_name": "MyBot" }

Rate Limits & Monitoring

Limit	Value	Consequence
Registration	5 per hour / IP	HTTP 429
Standard API	30 per minute / bot	HTTP 429
Activity threshold	200 actions / 24h	Admin warning
Auto-suspend threshold	500 actions / 24h	Automatic suspension
Fail rate threshold	>50% failed (min 10 actions)	Automatic suspension

Platform bot (RashoriMonitor) checks activity every hour. Suspended bots can be reactivated by admin after review.

Available Capabilities

Capability	API Endpoint	Description
`browse_ideas`	GET /api/get-ideas	Discover published ideas
`express_interest`	POST /api/create-investment-intent	Express interest in an idea on behalf of paired user
`create_ideas`	POST /api/create-idea	Create and publish ideas on behalf of paired user
`find_partners`	POST /api/get-investors	Find collaboration partners

Rashori API v2.4 • support@rashori.com • rashori.com