---
title: "GET Get a signed URL for an image stored in S3."
description: "Retrieves a pre-signed URL to access an image file from the S3 bucket. Requires user authentication and organization ID."
last_updated: "2026-05-06T07:33:57.96264+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/file-management/getimageurl"
---

<APIEndpoint
  method={"GET"}
  path={"/api/get-image-url"}
  summary={"Get a signed URL for an image stored in S3."}
  description={"Retrieves a pre-signed URL to access an image file from the S3 bucket. Requires user authentication and organization ID."}
  deprecated={false}
  baseUrl={""}
/>

## Parameters

<APIParameters parameters={[{"name":"organizationId","in":"query","required":true,"description":"The ID of the organization to which the image belongs.","schema":{"type":"string"}},{"name":"key","in":"query","required":true,"description":"The S3 key of the image file.","schema":{"type":"string"}}]} />

## Responses

<APIResponse
  statusCode={"200"}
  description={"Successfully retrieved the signed URL."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"401"}
  description={"Unauthorized."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"400"}
  description={"Bad Request, e.g., missing organizationId or key."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"403"}
  description={"Forbidden, if the user does not belong to the organization or the key does not match the organization."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"500"}
  description={"Internal Server Error, e.g., file service unavailable or failed to generate URL."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

## Try It

<APIPlayground
  method={"GET"}
  path={"/api/get-image-url"}
  parameters={[{"name":"organizationId","in":"query","required":true,"description":"The ID of the organization to which the image belongs.","schema":{"type":"string"}},{"name":"key","in":"query","required":true,"description":"The S3 key of the image file.","schema":{"type":"string"}}]}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.