Generated reference

Socialize

Generated API summary for Socialize from the source-controlled OpenAPI specification.

Version 1.0.0 24 operations 7 tags 2 security schemes

Auth

Default security: none declared

  • BearerAuth (http)
  • ApiKeyAuth (apiKey)

Servers

  • https://socialize-prod-api.topolo.workers.dev Production API
  • http://localhost:8787 Local development

Health

GET /health
Comprehensive health check

Returns detailed health status including dependency checks

Responses: 200, 503

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/health' \
  -H 'Accept: application/json'
GET /healthz
Liveness probe

Simple liveness check for container orchestration

Responses: 200

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/healthz' \
  -H 'Accept: application/json'
GET /readyz
Readiness probe

Check if service is ready to accept traffic

Responses: 200, 503

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/readyz' \
  -H 'Accept: application/json'

Posts

GET /api/posts
List posts

Auth: BearerAuth (http)

Responses: 200, 401

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/posts' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
POST /api/posts
Create a post

Auth: BearerAuth (http)

Responses: 201, 400, 401

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/posts' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'
GET /api/posts/{postId}
Get a post

Auth: BearerAuth (http)

Responses: 200, 404

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/posts/{postId}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
PUT /api/posts/{postId}
Update a post

Auth: BearerAuth (http)

Responses: 200, 404

curl -X PUT 'https://socialize-prod-api.topolo.workers.dev/api/posts/{postId}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'
DELETE /api/posts/{postId}
Delete a post

Auth: BearerAuth (http)

Responses: 204, 404

curl -X DELETE 'https://socialize-prod-api.topolo.workers.dev/api/posts/{postId}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Content Ops

GET /api/content-ops/queue
List machine-readable content queue items

Returns actionable content queue items for a brand, including approval state, publish status, timestamps, failure details, and supported safe actions. OpenClaw service requests may authenticate with `X-Api-Key` and should send `X-Brand-ID`.

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200, 401

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/queue' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
GET /api/content-ops/daily
Get deterministic daily content rollups

Returns a per-day rollup of content creation, approvals, scheduling, publishing, and failures. Buckets are derived from content timestamps rather than only the current status, so a publish later in the day does not erase earlier schedule activity.

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200, 401

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/daily' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
GET /api/content-ops/events
List content operations audit events

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200, 401

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/events' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
GET /api/content-ops/items/{contentId}
Get a content item with full machine-readable detail

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200, 404

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/items/{contentId}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
PATCH /api/content-ops/items/{contentId}
Edit draft content safely

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200

curl -X PATCH 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/items/{contentId}' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'
POST /api/content-ops/items/{contentId}/approve
Approve a suggestion draft

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/items/{contentId}/approve' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
POST /api/content-ops/items/{contentId}/reject
Reject a suggestion draft

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/items/{contentId}/reject' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
POST /api/content-ops/items/{contentId}/reschedule
Reschedule a queued or failed post

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/items/{contentId}/reschedule' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'
POST /api/content-ops/items/{contentId}/retry
Retry a failed publish

Auth: BearerAuth (http), ApiKeyAuth (apiKey)

Responses: 200

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/content-ops/items/{contentId}/retry' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'

Media

GET /api/media
List media files

Auth: BearerAuth (http)

Responses: 200

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/media' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
POST /api/media/upload
Get upload URL

Generate a presigned URL for direct upload to R2

Auth: BearerAuth (http)

Responses: 200

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/media/upload' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'

AI

POST /api/ai/generate-image
Generate AI image

Auth: BearerAuth (http)

Responses: 200, 429

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/ai/generate-image' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Brands

GET /api/brands
List user's brands

Auth: BearerAuth (http)

Responses: 200

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/brands' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
POST /api/brands
Create a brand

Auth: BearerAuth (http)

Responses: 201

curl -X POST 'https://socialize-prod-api.topolo.workers.dev/api/brands' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{}'

Integrations

GET /api/integrations/{platform}/connect
Start OAuth flow

Auth: BearerAuth (http)

Responses: 302

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/integrations/{platform}/connect' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'
GET /api/integrations
List connected integrations

Auth: BearerAuth (http)

Responses: 200

curl -X GET 'https://socialize-prod-api.topolo.workers.dev/api/integrations' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <token>'