Developers
Ask
Sign inSign in

Add content image

How does an image from the chat get into a content?

1 min readUpdated 15 November 2026
Short answer

dorna_add_content_image saves an image from this conversation to Dorna and adds it to one of your contents, at the end of the text or as the featured image.

  • dorna_add_content_image
  • Changes data
Contents
  1. Parameters
  2. What it returns
  3. Example
  4. Access and confirmation

Parameters

FieldTypeDescription
contentIdstring (ID)Required. The content to add the image to.
imageobjectRequired. The image to save: download_url and file_id are required; mime_type and file_name are optional. Only images from this conversation are accepted.
altstringRequired. A short description of the image, in Persian.
placementstringWhere the image goes: END appends it to the text (default), PRIMARY makes it the featured image.

What it returns

The content with the image added. With placement set to END (the default) the image goes to the end of the text, where dorna_update_content can move it.

Example

Ask your assistant: Add this image as the main picture of my launch reportage.

The assistant then calls the tool like this:

{
  "name": "dorna_add_content_image",
  "arguments": {
    "contentId": "64f1a2b3c4d5e6f7a8b9c0d1",
    "image": {
      "download_url": "https://…",
      "file_id": "file-123"
    },
    "alt": "Screenshot of the dashboard"
  }
}

A typical result looks like this (the values are examples):

{
  "contentId": "64f1a2b3c4d5e6f7a8b9c0d1",
  "fileId": "64f1a2b3c4d5e6f7a8b9c0d1",
  "url": "https://tech.example.com/article",
  "placement": "END"
}

Access and confirmation

Changes data: it adds something new to your account or creates a link.

Only images from this conversation are accepted, never a URL to an image on another site. Clients that cannot send a file use dorna_get_content_upload_link.

Related tools: dorna_get_content_upload_link dorna_update_content dorna_contents

Still have a question?

Open this guide in your own AI assistant and ask it.

ChatGPTClaudeGemini