CYcyberdesk-hq
workflows

Upload a workflow prompt image

Changed on

Upload an image to use in workflow prompts.

The returned supabase_url can be embedded directly in workflow prompt 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.

post/v1/workflows/prompt-image

Request

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

Headers

Idempotency-Keystring
Example:550e8400-e29b-41d4-a716-446655440000

Unique key for idempotent requests. If provided, the server ensures the request is processed at most once. Retries with the same key return the original response. SDKs auto-generate this for write requests.

Request body multipart/form-data

filestring binary required

The image file to upload

Response

Successful Response

supabase_urlstring required

The stable supabase:// URL to use in workflow prompt HTML. Example: supabase://workflow-prompt-images/org_xxx/prompt-assets/image.png

signed_urlstring required

A temporary signed URL for immediate display (expires in 1 hour)

filenamestring required

The sanitized filename as stored

content_typestring required

The MIME type of the uploaded image

size_bytesinteger required

The size of the uploaded file in bytes

Changes

  • 5579352ae05eRevision changes
    • breaking

      added required request body

    • info

      api operation id upload_workflow_prompt_image_v1_workflows_prompt_image_post was added

    • info

      the endpoint scheme security HTTPBearer was added to the API

    • info

      added the new optional header request parameter Idempotency-Key

    • info

      added the non-success response with the status

    • info

      added the success response with the status