Parameters

NameTypeRequiredDescription
brandIdstringYesBrand ID from ocoya_list_brands.
campaignIdstringYesCampaign ID from ocoya_list_campaigns or ocoya_create_ai_campaign.

Request example

{
  "name": "ocoya_get_campaign",
  "arguments": {
    "brandId": "cmayvq3hk00017apshay5qezu",
    "campaignId": "cmayxcmpn00087aps2m7hjs9z"
  }
}

Returns

Returns the same fields as each campaign in ocoya_list_campaigns, plus posts, in order. Each post has:

FieldDescription
sequencePosition in the campaign, from 1.
titleTitle, for a blog article.
captionPreviewThe caption, cut to 280 characters.
scheduledAtWhen the post is planned or scheduled to publish.
approvedWhether the post was approved in the campaign review.
postGroupIdThe saved post, once the campaign has saved it. Pass it to ocoya_get_post, ocoya_update_post or ocoya_schedule_post. null until then.
statusStatus of the saved post, such as DRAFT or SCHEDULED. null while it is not saved yet.
mediaCountImages or videos on the post.

Use it to follow a campaign started with ocoya_create_ai_campaign: status stays GENERATING until every post is written, and generation shows how far it got.

A campaign of another brand is not found. This tool only reads: it changes nothing in Ocoya. It needs the posts:read scope.