API Documentation

{
  "email": "user@example.com",
  "password": "securePassword123",
  "username": "johndoe",
  "full_name": "John Doe"
}

// 201 Created
{
  "message": "User registered successfully",
  "user": { "id": 1, "email": "user@example.com", ... },
  "access_token": "eyJhbGci...",
  "refresh_token": "eyJhbGci...",
  "token_type": "Bearer"
}

{
  "email": "user@example.com",
  "password": "securePassword123"
}

// 200 OK
{
  "message": "Login successful",
  "user": { "id": 1, "email": "user@example.com", ... },
  "access_token": "eyJhbGci...",
  "refresh_token": "eyJhbGci...",
  "token_type": "Bearer"
}

{
  "refresh_token": "eyJhbGci..."
}

// 200 OK
{
  "access_token": "eyJhbGci...",
  "token_type": "Bearer"
}

// 200 OK
{
  "user": {
    "id": 1,
    "email": "user@example.com",
    "username": "johndoe",
    "full_name": "John Doe",
    "role": "Admin",
    "is_platform_admin": false,
    "tenant_id": "550e8400-...",
    "created_at": "2025-01-01T00:00:00.000000"
  }
}

// 200 OK
{
  "api_keys": [
    {
      "id": 1,
      "name": "My Production Key",
      "prefix": "pa_123456",
      "is_active": true,
      "request_count": 42,
      "last_used_at": "2025-01-01T12:00:00.000000"
    }
  ]
}

{ "name": "My Production Key" }

// 201 Created
{
  "message": "API key created successfully",
  "api_key": "pa_1234567890abcdef...",
  "prefix": "pa_123456",
  "warning": "Save this key securely. You will not be able to see it again."
}

// 200 OK
{ "message": "API key deleted successfully" }

{
  "full_name": "John Doe",
  "username": "johndoe",
  "profile_image": "https://example.com/profile.jpg"
}

// 200 OK
{
  "message": "Profile updated successfully",
  "user": { "id": 1, "email": "...", "username": "johndoe", ... }
}

{
  "current_password": "oldPassword123",
  "new_password": "newPassword456"
}

// 200 OK
{ "message": "Password changed successfully" }

{
  "name": "John Doe",
  "email": "user@example.com",
  "subject": "Question about API",
  "message": "How do I get an API key?"
}

// 201 Created
{ "message": "Message sent successfully" }

// 200 OK
{
  "messages": [
    {
      "id": 1,
      "subject": "Welcome",
      "body": "...",
      "sender": { "id": 2, "full_name": "Admin" },
      "read": false,
      "created_at": "2025-01-01T00:00:00.000000"
    }
  ]
}

// 200 OK
{
  "articles": [
    {
      "id": 1,
      "title": "My Article",
      "slug": "my-article",
      "status": "published",
      "category_id": 2,
      "created_at": "2025-01-01T00:00:00.000000"
    }
  ],
  "total": 1, "page": 1, "per_page": 20
}

{
  "title": "My Article",
  "content": "Article body in markdown...",
  "category_id": 1,
  "status": "draft"
}

// 201 Created
{ "article": { "id": 1, "title": "My Article", ... } }

{ "title": "Updated Title", "status": "published" }

{
  "prompt": "Write about the future of AI in content creation",
  "category_id": 1,
  "tone": "professional",
  "length": "medium"
}

// 201 Created
{
  "article": {
    "id": 5,
    "title": "The Future of AI in Content Creation",
    "content": "...",
    "status": "draft"
  }
}

// Query params: ?q=keyword&status=published&category_id=1

// 200 OK
{ "categories": [{ "id": 1, "name": "Tech", "slug": "tech", "description": "...", "article_count": 5 }] }

{ "name": "Technology", "slug": "technology", "description": "Tech articles" }

{ "content": "Great article!" }

// 200 OK
{ "members": [{ "id": 1, "full_name": "Jane", "role": "Editor", "email": "..." }] }

{ "role": "Editor" }

{
  "name": "My Blog",
  "slug": "my-blog",
  "domain": "myblog.com",
  "description": "A personal tech blog"
}

{ "email": "newuser@example.com", "role": "Editor" }

// 201 Created
{ "message": "Invitation sent", "invitation_token": "abc123..." }

{ "token": "abc123..." }

{
  "scheduled_at": "2025-06-01T09:00:00Z",
  "timezone": "America/New_York"
}

// 200 OK
{ "message": "Article scheduled", "scheduled_at": "2025-06-01T09:00:00Z" }

{
  "platforms": ["twitter", "linkedin"],
  "custom_message": "Check out our latest article!",
  "schedule_at": null
}

// 200 OK
{ "plans": [{ "id": "pro", "name": "Pro", "price": 29, "features": [...] }] }

{ "plan_id": "pro", "payment_method_id": "pm_xxx" }

{
  "name": "Amazon Affiliate",
  "original_url": "https://amazon.com/product/123",
  "slug": "amz-product"
}

{ "is_platform_admin": true }

// 200 OK
{ "logs": [{ "id": 1, "action": "user.login", "user_id": 1, "ip": "127.0.0.1", "created_at": "..." }] }

// 200 OK
{ "status": "healthy", "version": "1.0.0", "db": "connected" }