Parameters

NameTypeRequiredDescription
brandIdstringYesBrand ID from ocoya_list_brands.
designIdstringYesStudio design ID from ocoya_list_studio_designs.
fieldsobjectNoValues keyed by field ID from ocoya_get_studio_design: text for a text field, an image URL for an image field, a CSS colour for a colour field.

Request example

{
  "name": "ocoya_render_studio_design",
  "arguments": {
    "brandId": "cmayvq3hk00017apshay5qezu",
    "designId": "cmayxdsgn00097apsk2v8q1rt",
    "fields": {
      "pixy-cmte4jx8o00ml3570hpuny2ze": "Summer sale, 20% off",
      "pixy-cmte3datf00f435708hleujti": "https://example.com/logo.png"
    }
  }
}

Returns

Returns the design’s ID and name, the rendered image url, and its mimetype (image/png).

Only the fields you pass change. Every other layer, including logos and photos, stays exactly as it is in the design, and the saved design itself is not changed.

Pass the url in mediaUrls to ocoya_create_post or ocoya_update_post to use the image in a post. To have the AI write the design’s text from a caption for you, use studioDesignId on ocoya_create_ai_post instead.