API Endpoint Reference

Quick reference for all API endpoints.

Authentication

All protected endpoints require: Authorization: Bearer <JWT>

Content APIs

Campaigns

GET    /api/campaigns           List campaigns
POST   /api/campaigns           Create campaign
GET    /api/campaigns/:id       Get campaign
PUT    /api/campaigns/:id       Update campaign
DELETE /api/campaigns/:id       Delete campaign
POST   /api/campaigns/:id/generate-plan    AI generate plan
POST   /api/campaigns/:id/generate-content AI generate content
GET    /api/campaigns/:id/content          Get campaign content

Brand Profile

GET    /api/brand-profile       Get brand profile
PUT    /api/brand-profile       Update brand profile

Blog Posts

GET    /api/blog/posts          List posts
POST   /api/blog/posts          Create post
GET    /api/blog/posts/:id      Get post
PUT    /api/blog/posts/:id      Update post
DELETE /api/blog/posts/:id      Delete post
POST   /api/blog/posts/:id/publish  Publish to destination

Social Posts

GET    /api/posts               List posts
POST   /api/posts               Create post
PUT    /api/posts/:id           Update post
DELETE /api/posts/:id           Delete post
POST   /api/posts/:id/schedule  Schedule post

AI Generation APIs

POST   /api/generate-posts         Generate social posts
POST   /api/generate-blog-post     Generate blog content
POST   /api/generate-video-script  Generate video script
POST   /api/generate-image         Generate image
POST   /api/ai/assist-post         AI assist for posts
POST   /api/analyze-brand          Analyze website for brand
POST   /api/chat-brand             Chat with brand consultant

Analytics & Reporting

GET    /api/analytics/overview     Dashboard metrics
GET    /api/analytics/growth       Follower growth
GET    /api/analytics/engagement   Engagement breakdown
GET    /api/analytics/best-times   Best posting times

GET    /api/reports                List reports
POST   /api/reports                Create report config
POST   /api/reports/:id/generate   Generate now
GET    /api/reports/export         Ad-hoc export

Publishing & Scheduling

GET    /api/queues                 List queues
POST   /api/queues                 Create queue
PUT    /api/queues/:id             Update queue
POST   /api/queues/:id/items       Add item to queue
DELETE /api/queues/:id/items/:id   Remove item

POST   /api/social/:platform/publish    Publish to platform
GET    /api/social/accounts             Connected accounts

Inbox & Engagement

GET    /api/inbox                  List conversations
GET    /api/inbox/:id              Get conversation
POST   /api/inbox/:id/reply        Reply to message
POST   /api/inbox/:id/archive      Archive conversation

GET    /api/approvals              List pending
POST   /api/approvals/:id/approve  Approve content
POST   /api/approvals/:id/reject   Reject content

Team & Settings

GET    /api/roles                  List roles
POST   /api/roles                  Create role
PUT    /api/roles/:id              Update role
DELETE /api/roles/:id              Delete role

GET    /api/team                   List team members
POST   /api/team/invite            Invite member
DELETE /api/team/:id               Remove member

Billing & Usage

POST   /api/billing/checkout       Create checkout URL
GET    /api/billing/subscription   Get subscription
POST   /api/billing/portal         Get portal URL

GET    /api/usage                  User usage
GET    /api/usage/company          Company usage (admin)


GET    /api/entitlements           Usage summary
GET    /api/entitlements/check/:action  Check action allowed

Admin APIs (Super Admin)

GET    /api/platform/segments      List segments
POST   /api/platform/segments      Create segment
PUT    /api/platform/segments/:id  Update segment

GET    /api/admin/config/features  List feature flags
PUT    /api/admin/config/features/:id  Update flag

GET    /api/admin/packages         List all packages
POST   /api/admin/packages         Create/update package

Common Response Patterns

Success

{ "data": {...}, "meta": { "total": 100 } }

Error

{ "error": "Error Type", "message": "Details", "statusCode": 400 }

Pagination

?limit=20&offset=0