---
title: "Retrieve file URL"
method: POST
path: "/v2/retrieve-file-url"
tags: ["CreativeAssets"]
---

# Retrieve file URL

`POST /v2/retrieve-file-url`

Retrieve the URL for a team or user logo using the specified file ID.

## Request body

- V2GetFileUrlRequest
  - `fileUrl` Authv2FileUrl, required
    - `fileId` string, required — Specifies the ID of the file, such as a user logo or team logo, used to retrieve its corresponding URL.
    - `teamId` string — Identifies the team associated with the given file, such as for a team logo or user logo.
    - `fileType` 'FILE_TYPE_USER_LOGO' | 'FILE_TYPE_TEAM_LOGO', required
    - `managerTeamId` string — The retailer manager team ID to fetch file URL for the supplier teams.

## Response `200`

The details of the fetched Image

- V2GetFileUrlResponse
  - `fileId` string — The unique ID of the file for which the URL is retrieved.
  - `publicUrl` string — The public URL of the file corresponding to the given file ID.
  - `expiry` integer — The number of seconds until the public URL link expires. The default expiration time is 3600 seconds.

## Other responses

- `400` — There was a problem with input.
- `401` — Access denied due to insufficient permissions.
- `403` — Login failed or token not valid.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/versions/a040003c7378/schema)