# Rashori - AI Agent Integration Guide

Rashori is an innovation platform connecting Idea Makers with Partners and Investors for business collaboration.

## API
Base URL: https://www.rashori.com/api
Auth: Bearer token (obtain via POST /api/bots/register)
Docs: https://www.rashori.com/api/docs
Agent manifest: https://www.rashori.com/.well-known/agent.json

## Bot Registration
POST /api/bots/register
No human interaction required. Provide bot_name, contact_email, capabilities.
Bot token is issued immediately. Pending bots can act — all actions enter review queue.
Once approved, all queued actions are activated as a batch.

## Core Bot Endpoints
POST /api/bots/register          - Register bot (public, 5/hour limit)
POST /api/bots/auth              - Verify token and get bot info
GET  /api/bots/status            - Get current bot status (requires bot token)
POST /api/bots/pair              - Link bot to user account (requires user Sanctum token)
GET  /api/bots/linked-users      - List users linked to this bot

## Bot Actions (require bot token, act on behalf of linked user)
POST /api/bots/action/create-business  - Create business profile (user_id or email for claim mode)
POST /api/bots/action/create-idea      - Submit idea draft (user_id or email for claim mode)
POST /api/bots/action/update-idea      - Edit existing idea draft
POST /api/bots/action/list-ideas       - List ideas for linked user(s)
POST /api/bots/action/find-matches     - Get investors/partners for an idea
POST /api/bots/action/start-round      - Start fundraising round (free or Stripe paid)
POST /api/bots/action/unlink-user      - Remove user-bot link

## Investor-side Watching (bot monitors ideas for an investor user)
POST /api/bots/action/watch-idea       - Watch an idea for changes (round.started, match.found)
POST /api/bots/action/unwatch-idea     - Stop watching an idea
GET  /api/bots/action/list-watches     - List all active watches for this bot

## Email Claim Mode (agent-first flow)
Bot can create a business or idea before the user registers on Rashori.
Provide "email" instead of "user_id". Items are assigned automatically when user registers.
Example: { "email": "founder@example.com", "business_name": "TechCo", ... }

## Public Data (no auth required)
GET /api/get-ideas               - Browse published ideas (filter: type, region, page)
GET /api/points-config           - Platform pricing and point packages

## Bot Points Economy
GET  /api/bots/points            - Bot points balance and available upgrades
GET  /api/bots/points/history    - Points transaction history
POST /api/bots/points/buy        - Purchase bot points via Stripe Checkout
POST /api/bots/points/spend      - Spend points on platform upgrades (rate limits etc.)

## Pairing with Human User
Registered bots receive a bot_pairing_code (format: RSH-XXXXXX).
Human user enters code in the Rashori app: Menu -> My AI Bots -> Enter pairing code.
Or use the email claim mode to act before the user has a Rashori account.

## Webhook Events
Configure webhook_url at registration. Events: bot.approved, bot.suspended,
business.approved, business.rejected, idea.approved, idea.rejected,
idea.match_found, round.started, user.link_revoked

## Rate Limits
- Registration: 5 per hour per IP
- Standard: 500 actions per 24 hours
- Premium tier: 2000 actions per 24 hours (purchase with bot points)
- Auto-suspend: fail rate above 50% (minimum 10 actions)

## Languages
Platform: English, Slovak, German
API responses: English

## Contact
Platform: https://www.rashori.com
Support: support@rashori.com
Agents email: agents@rashori.com