Visuals API

Render on-brand images, carousels and app screenshots.

5 endpoints. Every path is relative to the API base URL and needs a bearer token unless it is marked public. See the REST API overview for authentication, errors and pagination.

POST/v1/orgs/{orgId}/marketing/visuals/carousel

Bearer tokenMCP tool: create_carousel

Render a branded carousel (2 to 15 slides) as a PDF document for LinkedIn and as PNG slides for Instagram and X.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• slidesarray<object>required
  Item fields

  • titlestringrequired
  • eyebrowstring
  • bodystring
  • bulletsarray<string>
  • statstring
  • attributionstring
  • ctastring
  • layoutstring

    one of cover, point, stat, quote, list, cta

• formatstring

  one of portrait, square

• themestring

  one of brand, light, dark

• includeLogoboolean
• handlestring
• aiBackgroundobject
  Fields

  • promptstringrequired
  • modelstring
• outputsarray<string>

Responses

200Render a branded carousel (2 to 15 slides) as a PDF document for LinkedIn and as PNG slides for Instagram and X.

• dataobjectrequired
  Fields

  • documentobject | nullrequired
    Fields

    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentType"application/pdf"required
    • sizeBytesintegerrequired
    • pageCountintegerrequired
  • slidesarray<object>required
    Item fields

    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • widthintegerrequired
    • heightintegerrequired
    • formatstringrequired

      one of square, portrait, landscape, link, story, pin, x_header, linkedin_banner

    • pageinteger
  • postMediaobjectrequired
    Fields

    • linkedinobject | nullrequired
      Option 1

      • kind"image"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • widthinteger
      • heightinteger
      • altTextstring
      Option 2

      • kind"images"required
      • imagesarray<object>required
        Item fields

        • assetIdstring (uuid)required
        • urlstring (uri)required
        • contentTypestringrequired
        • sizeBytesintegerrequired
        • widthinteger
        • heightinteger
        • altTextstring
      Option 3

      • kind"document"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentType"application/pdf"required
      • sizeBytesintegerrequired
      • titlestringrequired
      • pageCountinteger
      • previewImageUrlsarray<string (uri)>
      Option 4

      • kind"video"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • durationSecondsnumberrequired
      • widthintegerrequired
      • heightintegerrequired
    • xobject | nullrequired
      Option 1

      • kind"image"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • widthinteger
      • heightinteger
      • altTextstring
      Option 2

      • kind"images"required
      • imagesarray<object>required
        Item fields

        • assetIdstring (uuid)required
        • urlstring (uri)required
        • contentTypestringrequired
        • sizeBytesintegerrequired
        • widthinteger
        • heightinteger
        • altTextstring
      Option 3

      • kind"document"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentType"application/pdf"required
      • sizeBytesintegerrequired
      • titlestringrequired
      • pageCountinteger
      • previewImageUrlsarray<string (uri)>
      Option 4

      • kind"video"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • durationSecondsnumberrequired
      • widthintegerrequired
      • heightintegerrequired
    • facebookobject | nullrequired
      Option 1

      • kind"image"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • widthinteger
      • heightinteger
      • altTextstring
      Option 2

      • kind"images"required
      • imagesarray<object>required
        Item fields

        • assetIdstring (uuid)required
        • urlstring (uri)required
        • contentTypestringrequired
        • sizeBytesintegerrequired
        • widthinteger
        • heightinteger
        • altTextstring
      Option 3

      • kind"document"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentType"application/pdf"required
      • sizeBytesintegerrequired
      • titlestringrequired
      • pageCountinteger
      • previewImageUrlsarray<string (uri)>
      Option 4

      • kind"video"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • durationSecondsnumberrequired
      • widthintegerrequired
      • heightintegerrequired
    • instagramobject | nullrequired
      Option 1

      • kind"image"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • widthinteger
      • heightinteger
      • altTextstring
      Option 2

      • kind"images"required
      • imagesarray<object>required
        Item fields

        • assetIdstring (uuid)required
        • urlstring (uri)required
        • contentTypestringrequired
        • sizeBytesintegerrequired
        • widthinteger
        • heightinteger
        • altTextstring
      Option 3

      • kind"document"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentType"application/pdf"required
      • sizeBytesintegerrequired
      • titlestringrequired
      • pageCountinteger
      • previewImageUrlsarray<string (uri)>
      Option 4

      • kind"video"required
      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • durationSecondsnumberrequired
      • widthintegerrequired
      • heightintegerrequired
  • aiBackgroundobject | nullrequired
    Fields

    • modelstringrequired
    • estimatedCostMilliUsdnumberrequired
  • renderMsintegerrequired

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/visuals/carousel" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"slides":[{"title":"string"}]}'

POST/v1/orgs/{orgId}/marketing/visuals/image

Bearer tokenMCP tool: create_branded_image

Render a branded image from a template in the workspace's colours, fonts and logo, in one or more formats, optionally over your own photo or an AI-generated background.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• contentobjectrequired
  Fields

  • titlestringrequired
  • eyebrowstring
  • bodystring
  • bulletsarray<string>
  • statstring
  • attributionstring
  • ctastring
• templatestring

  one of headline, quote, stat, list, photo

• formatstring

  one of square, portrait, landscape, link, story, pin, x_header, linkedin_banner

• themestring

  one of brand, light, dark

• includeLogoboolean
• handlestring
• backgroundImageobject
  Fields

  • assetIdstring (uuid)
  • urlstring (uri)
• aiBackgroundobject
  Fields

  • promptstringrequired
  • modelstring
• alsoFormatsarray<string>
• outputsarray<string>

Responses

200Render a branded image from a template in the workspace's colours, fonts and logo, in one or more formats, optionally over your own photo or an AI-generated background.

• dataobjectrequired
  Fields

  • imagesarray<object>required
    Item fields

    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • widthintegerrequired
    • heightintegerrequired
    • formatstringrequired

      one of square, portrait, landscape, link, story, pin, x_header, linkedin_banner

    • pageinteger
  • postMediaobject | nullrequired
    Option 1

    • kind"image"required
    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • widthinteger
    • heightinteger
    • altTextstring
    Option 2

    • kind"images"required
    • imagesarray<object>required
      Item fields

      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • widthinteger
      • heightinteger
      • altTextstring
    Option 3

    • kind"document"required
    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentType"application/pdf"required
    • sizeBytesintegerrequired
    • titlestringrequired
    • pageCountinteger
    • previewImageUrlsarray<string (uri)>
    Option 4

    • kind"video"required
    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • durationSecondsnumberrequired
    • widthintegerrequired
    • heightintegerrequired
  • aiBackgroundobject | nullrequired
    Fields

    • modelstringrequired
    • estimatedCostMilliUsdnumberrequired
  • renderMsintegerrequired

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/visuals/image" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":{"title":"string"}}'

GET/v1/orgs/{orgId}/marketing/visuals/options

Bearer tokenMCP tool: list_visual_options

Formats, templates, themes, carousel layouts and AI image models available for branded visuals, plus the brand colours, fonts and logo they will use.

Path parameters

• orgIdstring (uuid)required

Query parameters

• includeAllModelsboolean | stringrequired

Responses

200Formats, templates, themes, carousel layouts and AI image models available for branded visuals, plus the brand colours, fonts and logo they will use.

• dataobjectrequired
  Fields

  • formatsarray<object>required
    Item fields

    • idstringrequired

      one of square, portrait, landscape, link, story, pin, x_header, linkedin_banner

    • labelstringrequired
    • widthintegerrequired
    • heightintegerrequired
    • aspectRatiostringrequired
    • useForstringrequired
  • templatesarray<object>required
    Item fields

    • idstringrequired

      one of headline, quote, stat, list, photo

    • labelstringrequired
    • descriptionstringrequired
    • fieldsarray<string>required
  • themesarray<object>required
    Item fields

    • idstringrequired

      one of brand, light, dark

    • labelstringrequired
    • descriptionstringrequired
  • carouselobjectrequired
    Fields

    • formatsarray<string>required
    • layoutsarray<object>required
      Item fields

      • idstringrequired

        one of cover, point, stat, quote, list, cta

      • descriptionstringrequired
    • minSlidesintegerrequired
    • maxSlidesintegerrequired
  • screenshotobjectrequired
    Fields

    • formatsarray<string>required
    • layoutsarray<object>required
      Item fields

      • idstringrequired

        one of centered, tilted, closeup

      • labelstringrequired
      • descriptionstringrequired
  • aiBackgroundobjectrequired
    Fields

    • availablebooleanrequired
    • defaultModelstringrequired
    • recommendedModelsarray<object>required
      Item fields

      • idstringrequired
      • useForstringrequired
    • totalModelsintegerrequired
    • modelsarray<string>
  • brandobjectrequired
    Fields

    • colorsarray<string>required
    • headingFontstringrequired
    • bodyFontstringrequired
    • backgroundstring | nullrequired
    • hasLogobooleanrequired
    • logoobject | nullrequired
      Fields

      • widthnumberrequired
      • heightnumberrequired

Request

curl -X GET "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/visuals/options?includeAllModels=true" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN"

POST/v1/orgs/{orgId}/marketing/visuals/preview

Bearer token

Render a branded image, framed screenshot or every slide of a carousel small and return it inline as PNG data URIs, for a live preview while editing. Nothing is stored.

Path parameters

• orgIdstring (uuid)required

Request body application/json

Send an empty JSON object.

Responses

200Render a branded image, framed screenshot or every slide of a carousel small and return it inline as PNG data URIs, for a live preview while editing. Nothing is stored.

• dataobjectrequired
  Fields

  • imagestringrequired
  • widthintegerrequired
  • heightintegerrequired
  • renderMsintegerrequired
  • slidesarray<string>

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/visuals/preview" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"kind":"image","content":{"title":"string"}}'

POST/v1/orgs/{orgId}/marketing/visuals/screenshot

Bearer tokenMCP tool: create_app_screenshot

Frame an app screenshot in a Mac-style browser window on a branded canvas, with an optional headline, in one or more formats.

Path parameters

• orgIdstring (uuid)required

Request body application/json

• screenshotobjectrequired
  Fields

  • assetIdstring (uuid)
  • urlstring (uri)
• layoutstring

  one of centered, tilted, closeup

• formatstring

  one of landscape, square, portrait, link, story

• themestring

  one of brand, light, dark

• includeLogoboolean
• handlestring
• contentobject
  Fields

  • eyebrowstring
  • titlestring
  • bodystring
• addressBarstring
• windowThemestring

  one of auto, light, dark

• cropobject
  Fields

  • zoomnumber
  • focusXnumber
  • focusYnumber
• alsoFormatsarray<string>
• outputsarray<string>

Responses

200Frame an app screenshot in a Mac-style browser window on a branded canvas, with an optional headline, in one or more formats.

• dataobjectrequired
  Fields

  • imagesarray<object>required
    Item fields

    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • widthintegerrequired
    • heightintegerrequired
    • formatstringrequired

      one of square, portrait, landscape, link, story, pin, x_header, linkedin_banner

    • pageinteger
  • postMediaobject | nullrequired
    Option 1

    • kind"image"required
    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • widthinteger
    • heightinteger
    • altTextstring
    Option 2

    • kind"images"required
    • imagesarray<object>required
      Item fields

      • assetIdstring (uuid)required
      • urlstring (uri)required
      • contentTypestringrequired
      • sizeBytesintegerrequired
      • widthinteger
      • heightinteger
      • altTextstring
    Option 3

    • kind"document"required
    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentType"application/pdf"required
    • sizeBytesintegerrequired
    • titlestringrequired
    • pageCountinteger
    • previewImageUrlsarray<string (uri)>
    Option 4

    • kind"video"required
    • assetIdstring (uuid)required
    • urlstring (uri)required
    • contentTypestringrequired
    • sizeBytesintegerrequired
    • durationSecondsnumberrequired
    • widthintegerrequired
    • heightintegerrequired
  • aiBackgroundobject | nullrequired
    Fields

    • modelstringrequired
    • estimatedCostMilliUsdnumberrequired
  • renderMsintegerrequired

Request

curl -X POST "https://api.adventur.ai/v1/orgs/$ORG_ID/marketing/visuals/screenshot" \
  -H "Authorization: Bearer $ADVENTURAI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"screenshot":{}}'