API Overview

Gramsea API

Access Gramsea functionality programmatically via our REST API.

Authentication

The API uses Bearer token authentication. Create tokens in your API Tokens section.

Authorization: Bearer your-api-token

Base URL

https://your-domain.com/api/v1

Available Endpoints

User

• GET /user - Get profile
• GET /user/credit - Get credit balance

Bots

• GET /bots - List bots
• POST /bots - Create bot
• GET /bots/{id} - Get bot
• PUT /bots/{id} - Update bot
• DELETE /bots/{id} - Delete bot
• POST /bots/{id}/activate - Activate bot
• POST /bots/{id}/deactivate - Deactivate bot

Bot Messages

• GET /bots/{id}/messages - List messages
• POST /bots/{id}/messages - Create message
• PUT /bots/{id}/messages/{messageId} - Update message
• DELETE /bots/{id}/messages/{messageId} - Delete message

Response Format

All responses are JSON. Successful responses include a data key, errors include an error key.