# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Optimizely Assets API version: 1.0.0 extends: openapi/optimizely-assets-api-openapi.yml actions: - target: $.info update: x-apievangelist-phrasing: method: generated generated: '2026-09-26' generator: build-phrasing.py label: Generated by API Evangelist operations: 14 - target: $.paths['/{clientId}/assets'].get update: x-apievangelist-phrasing: intent: List campaign assets for a Campaign client effect: read questions: - Which images and media files are stored for my Optimizely Campaign client? - Can I see all the campaign assets available to a client ID? instructions: - text: List the campaign assets for client {clientId}. slots: clientId: path.clientId - text: Show all media files stored under Campaign client {clientId}. slots: clientId: path.clientId method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets'].post update: x-apievangelist-phrasing: intent: Upload a campaign asset effect: write questions: - How do I upload a media file to use in my campaigns? - Can I give a campaign asset a name when I upload it? instructions: - text: Upload a campaign asset named {name} to client {clientId}. slots: name: requestBody.name clientId: path.clientId - text: Add this file {file} as a campaign asset for client {clientId}. slots: file: requestBody.file clientId: path.clientId method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets/images/count'].get update: x-apievangelist-phrasing: intent: Count the images in a Campaign client effect: read questions: - How many images are stored in my campaign image library? - What is the total image count for a client? instructions: - text: Count the images stored for client {clientId}. slots: clientId: path.clientId - text: Tell me the total number of images in client {clientId}. slots: clientId: path.clientId method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets/images'].get update: x-apievangelist-phrasing: intent: List campaign images with dimensions effect: read questions: - Can I get every campaign image with its URL, width and height? - Is there a way to page through my images a batch at a time? instructions: - text: List the images for client {clientId}. slots: clientId: path.clientId - text: Show {limit} images for client {clientId} starting at offset {offset}. slots: limit: query.limit clientId: path.clientId offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets/images'].post update: x-apievangelist-phrasing: intent: Upload an image to a Campaign client effect: write questions: - How do I upload an image file for use in mailings? - Can I add a campaign image from a file and give it a name? instructions: - text: Upload image {file} to client {clientId}. slots: file: requestBody.file clientId: path.clientId - text: Upload image {file} named {name} to the image library of client {clientId}. slots: file: requestBody.file name: requestBody.name clientId: path.clientId method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets/images/{imageId}'].get update: x-apievangelist-phrasing: intent: Get details of one campaign image effect: read questions: - What is the URL and pixel size of a specific campaign image? - How can I look up a single image by its ID? instructions: - text: Get image {imageId} for client {clientId}. slots: imageId: path.imageId clientId: path.clientId - text: Show the name, URL and dimensions of image {imageId}. slots: imageId: path.imageId method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets/images/{imageId}'].post update: x-apievangelist-phrasing: intent: Rename a campaign image effect: write questions: - Can I rename an image that is already uploaded? - How do I change a campaign image's name? instructions: - text: Rename image {imageId} in client {clientId} to {name}. slots: imageId: path.imageId clientId: path.clientId name: requestBody.name - text: Change the name of image {imageId} to {name}. slots: imageId: path.imageId name: requestBody.name method: generated generated: '2026-09-26' - target: $.paths['/{clientId}/assets/images/{imageId}'].delete update: x-apievangelist-phrasing: intent: Delete a campaign image effect: destructive questions: - How do I remove an image from my campaign image library? - Can I delete an image I uploaded by mistake? instructions: - text: Delete image {imageId} from client {clientId}. slots: imageId: path.imageId clientId: path.clientId - text: Remove campaign image {imageId}. slots: imageId: path.imageId method: generated generated: '2026-09-26' - target: $.paths['/assets'].get update: x-apievangelist-phrasing: intent: List assets in the CMP library effect: read questions: - What images, videos and raw files are in my Content Marketing Platform library? - Can I page through CMP library assets with a limit and offset? instructions: - text: List the assets in my CMP library. - text: Show {limit} CMP library assets, skipping the first {offset}. slots: limit: query.limit offset: query.offset method: generated generated: '2026-09-26' - target: $.paths['/assets'].post update: x-apievangelist-phrasing: intent: Add an asset to the CMP library effect: write questions: - How do I upload a new file into the CMP asset library? - Can I set a title and description when adding a library asset? instructions: - text: Upload {file} to the CMP library with title {title}. slots: file: requestBody.file title: requestBody.title - text: Create a CMP library asset titled {title} described as {description}. slots: title: requestBody.title description: requestBody.description method: generated generated: '2026-09-26' - target: $.paths['/assets/{assetId}'].get update: x-apievangelist-phrasing: intent: Get a CMP library asset effect: read questions: - How do I look up the details of one asset in the CMP library? - What metadata does a specific library asset have? instructions: - text: Get CMP asset {assetId}. slots: assetId: path.assetId - text: Show the details of library asset {assetId}. slots: assetId: path.assetId method: generated generated: '2026-09-26' - target: $.paths['/assets/{assetId}'].put update: x-apievangelist-phrasing: intent: Update a CMP asset's metadata effect: write questions: - Can I change the title or description of a library asset? - How do I add labels to an asset in the CMP library? instructions: - text: Retitle CMP asset {assetId} to {title}. slots: assetId: path.assetId title: requestBody.title - text: Set labels {labels} on library asset {assetId}. slots: labels: requestBody.labels assetId: path.assetId method: generated generated: '2026-09-26' - target: $.paths['/assets/{assetId}'].delete update: x-apievangelist-phrasing: intent: Permanently delete a CMP asset effect: destructive questions: - How do I permanently remove an asset from the CMP library? - Is deleting a library asset reversible? instructions: - text: Delete CMP asset {assetId}. slots: assetId: path.assetId - text: Permanently remove library asset {assetId}. slots: assetId: path.assetId method: generated generated: '2026-09-26' - target: $.paths['/asset-urls/{asset_id}'].get update: x-apievangelist-phrasing: intent: Find the URL of an asset effect: read questions: - What is the hosted URL of an asset when all I have is its ID? - Can I resolve an asset ID to a link I can use? instructions: - text: Find the URL for asset {asset_id}. slots: asset_id: path.asset_id - text: Give me the link to asset {asset_id}. slots: asset_id: path.asset_id method: generated generated: '2026-09-26'