Skip to main content

​
Dates

Use ISO 8601 datetime strings for scheduled post times.
Use UTC when possible. If you generate local times in your app, convert them to a timezone-aware ISO string before sending the request.

​
Pagination

List endpoints can accept pagination parameters such as page and perPage when supported by the endpoint. Use small page sizes for user-facing interfaces and larger page sizes only for background jobs that can tolerate slower responses.

​
Media URLs

Post media URLs must be absolute URLs that Ocoya can fetch.
Avoid private URLs, expiring URLs with very short lifetimes, and files that require cookies or custom request headers.

​
Workspace-Scoped Requests

Most publishing and workflow operations need a workspaceId. Use GET /workspaces first, then pass the selected workspace ID to endpoints such as:
  • GET /social-profiles
  • GET /brand-kits
  • GET /hashtag-libraries
  • GET /post
  • POST /post
  • POST /post/ai
  • POST /campaigns
  • GET /workflow

​
Social Profile IDs

Use GET /social-profiles?workspaceId=WORKSPACE_ID to find the socialProfileIds that posts should target. Only use profiles connected to the same workspace as the post.