Endpoints

Method	Path	Purpose
GET	/ai/status	Check availability
POST	/ai/generate-content	Generate platform captions
POST	/ai/suggest-hashtags	Suggest hashtags per platform

AI features require Pro or Business tier.

GET /ai/status

{
  "success": true,
  "data": { "available": true, "model": "gemini-2.0-flash" }
}

POST /ai/generate-content

curl -X POST https://api.socifyr.com/api/ai/generate-content \
  -H "Authorization: Bearer sk_..." \
  -H "X-Workspace-Id: <workspaceId>" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadType": "video",
    "platforms": ["instagram", "linkedin"],
    "title": "Product launch",
    "description": "We are shipping our new SDK",
    "tone": "professional",
    "brandVoice": "We speak with authority but stay approachable"
  }'

Field	Type	Description
uploadType	text / photo / video / document	Required
platforms	string[]	Required — target platforms
text / title / description	string?	Context for the AI
tone	professional / casual / humorous / inspirational / informative	Optional
brandVoice	string?	Free-text brand instructions

Response:

{
  "success": true,
  "data": {
    "content": {
      "instagram": "...",
      "linkedin": "..."
    }
  }
}

POST /ai/suggest-hashtags

curl -X POST https://api.socifyr.com/api/ai/suggest-hashtags \
  -H "Authorization: Bearer sk_..." \
  -H "X-Workspace-Id: <workspaceId>" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Launching our social automation SDK",
    "platforms": ["instagram", "x"],
    "count": 15,
    "existingHashtags": ["#devtools"]
  }'

Response:

{
  "success": true,
  "data": [
    { "platform": "instagram", "hashtags": ["#socialmedia", "#automation", "..."] },
    { "platform": "x", "hashtags": ["#dev", "#api", "..."] }
  ]
}