Social Posts API ​
Manage social media posts, drafts, and scheduling.
Endpoints ​
List Posts ​
GET /api/social-posts
Returns a list of all posts for the authenticated company.
Response:
json
[
{
"id": "uuid",
"content": "Hello world",
"status": "DRAFT",
"platforms": ["twitter"],
"createdAt": "2026-01-01T00:00:00Z"
}
]1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
Create Draft ​
POST /api/social-posts
Creates a new post in DRAFT status.
Body:
json
{
"content": "Draft content",
"platforms": ["linkedin"],
"status": "DRAFT",
"mediaAssetIds": []
}1
2
3
4
5
6
2
3
4
5
6
Publish / Schedule ​
POST /api/social-posts/batch-schedule
Publishes immediately or schedules for a future date.
Body:
json
{
"content": "Going live!",
"platforms": ["twitter", "linkedin"],
"scheduledAt": "2026-02-20T10:00:00Z", // Optional, defaults to now
"mediaAssetIds": ["uuid-1"]
}1
2
3
4
5
6
2
3
4
5
6
Update Post ​
PUT /api/social-posts/:id
Updates an existing draft or scheduled post.
Body:
json
{
"content": "Updated content",
"platforms": ["twitter"],
"status": "DRAFT"
}1
2
3
4
5
2
3
4
5
Delete Post ​
DELETE /api/social-posts/:id
Removes a post record.