---
title: "Upload a workflow prompt image"
method: POST
path: "/v1/workflows/prompt-image"
tags: ["workflows"]
---

# Upload a workflow prompt image

`POST /v1/workflows/prompt-image`

## Request

- Base URL: `https://api.cyberdesk.io`
- URL: `https://api.cyberdesk.io/v1/workflows/prompt-image`
- Auth: HTTP bearer

Upload an image to use in workflow prompts. 

The returned `supabase_url` can be embedded directly in workflow prompt HTML:

```html
<img src="supabase://workflow-prompt-images/org_xxx/prompt-assets/my-image.png" alt="Description">
```

When the workflow runs, Cyberdesk automatically resolves these URLs to display the image
to the AI agent.

Supported formats: PNG, JPEG, GIF, WebP. Maximum size: 10MB.

## Headers

- `Idempotency-Key` string

## Request body `multipart/form-data`

- BodyUploadWorkflowPromptImageV1WorkflowsPromptImagePost
  - `file` string, binary, required: The image file to upload

## Response `201`

Successful Response

- WorkflowPromptImageResponse: Response schema for uploaded workflow prompt image
  - `supabase_url` string, required: The stable supabase:// URL to use in workflow prompt HTML. Example: supabase://workflow-prompt-images/org_xxx/prompt-assets/image.png
  - `signed_url` string, required: A temporary signed URL for immediate display (expires in 1 hour)
  - `filename` string, required: The sanitized filename as stored
  - `content_type` string, required: The MIME type of the uploaded image
  - `size_bytes` integer, required: The size of the uploaded file in bytes

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-03** `5579352ae05e`: 1 breaking, 5 info
  - added required request body
  - api operation id `upload_workflow_prompt_image_v1_workflows_prompt_image_post` was added
  - the endpoint scheme security `HTTPBearer` was added to the API
  - added the new optional `header` request parameter `Idempotency-Key`
  - …2 more

[Operation history](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/changes/v1/workflows/prompt-image/post.md)

---

[API](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud.md) - [All operations](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/cyberdesk-hq/apis/cyberdesk-cloud/revisions/5579352ae05e?raw)