Skip to main content
POST
/
api
/
social-copy-jobs
cURL
curl --request POST \
  --url https://api.opus.pro/api/social-copy-jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "P0000000demo",
  "clipId": "CUexample1",
  "postAccountId": "postAccountId_xxx1",
  "subAccountId": "subAccountId_xxx1",
  "prompt": "Write the caption in a playful, witty tone that uses humor to keep the audience engaged, while ending with a clear call to action.",
  "forceRegenerate": false
}
'
{
  "data": {
    "jobId": "96e3d68c-49ef-4c19-b3b6-595f9564537c"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
projectId
string
required

Project ID

​
clipId
string
required

Bare clip ID (e.g. CUexample1). Not the composite {projectId}.{clipId} form returned as id by GET /api/exportable-clips — pass only the part after the dot.

​
postAccountId
string
required

Unique ID of the connected social account record

​
subAccountId
string
required

Sub-account ID used by Facebook pages, Instagram business accounts, or LinkedIn

​
prompt
string

Custom style or tone instruction for generation

​
forceRegenerate
boolean

Whether to bypass the cached result and regenerate

Response

201 - application/json

Successfully created a social copy generation job

​
data
object
required