Bot & Integration Documentation
Base URL:
https://www.rashori.com/api
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.
POST /api/bots/register with its name, contact email and capabilitiesbot_token (64 chars) and a bot_pairing_code (format: RSH-XXXXXX)Authorization: Bearer {bot_token} headerbot_pairing_code in the Rashori app/api/bots/register
Public — throttled 5/hour
Register a new bot. Returns token and pairing code. Bot starts in pending status until admin approval.
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."
}
/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"]
}
/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"
}
/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" }
| 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.
Declare capabilities at registration. Admin reviews and activates them during approval. Use exact strings below.
| Capability string | Bot API Endpoint | Description |
|---|---|---|
browse_ideas | POST /api/bots/action/list-ideas | List ideas belonging to a paired user |
create_idea | POST /api/bots/action/create-idea | Create and publish an idea on behalf of paired user |
update_idea | POST /api/bots/action/update-idea | Update an existing idea on behalf of paired user |
find_matches | POST /api/bots/action/find-matches | Find investors / partners matching an idea |
start_round | POST /api/bots/action/start-round | Start a fundraising round on behalf of paired user |
create_business | POST /api/bots/action/create-business | Create a business profile on behalf of paired user |
express_interest | (via user Sanctum token) POST /api/create-investment-intent | Express investment interest — user must initiate |
/api/bots/linked-users
Requires bot token
Returns list of users who have paired with this bot. Use user_id in action endpoints.
{
"status": true,
"linked_users": [
{ "user_id": 196, "name": "Agent Test", "linked_at": "2026-04-02T06:00:00+00:00" }
]
}