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

# Retrieve campaign file URL

`POST /v3/campaign-file-url`

This endpoint retrieves the URL for uploaded campaign assets for banners, banner X, and brand page campaigns. The URL is generated based on the specified file ID and file type.

## Request body

- V3GetCampaignFileUrlRequest
  - `fileUrl` Campaignv3FileUrl, required
    - `fileId` string, required — Specifies the ID of the file used to retrieve its corresponding URL.
    - `teamId` string — Identifies the team associated with the given file.
    - `campaignFileType` 'CAMPAIGN_FILE_TYPE_BANNER_X_IMAGE' | 'CAMPAIGN_FILE_TYPE_BANNER_IMAGE' | 'CAMPAIGN_FILE_TYPE_BANNER_X_CONTENT_STANDARD_DISPLAY_LOGO' | 'CAMPAIGN_FILE_TYPE_BANNER_X_CONTENT_STANDARD_PDF_FILE' | 'CAMPAIGN_FILE_TYPE_BANNER_CONTENT_STANDARD_DISPLAY_LOGO' | 'CAMPAIGN_FILE_TYPE_BANNER_CONTENT_STANDARD_PDF_FILE' | 'CAMPAIGN_FILE_TYPE_BRAND_PAGE_IMAGE', required
    - `slotId` string — The unique identifier of the slot.
    - `contentStandardId` string — The unique identifier of the content standard.
    - `managerTeamId` string — The retailer team ID to fetch file URL for the supplier teams.

## Response `200`

The details of the retrieved file.

- V3GetCampaignFileUrlResponse
  - `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` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `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/revisions/a040003c7378/schema)