---
title: "Upload a branding icon"
method: POST
path: "/files/branding_icons"
tags: ["File"]
---

# Upload a branding icon

`POST /files/branding_icons`

## Request

- Base URL: `https://telescope.ac/api`
- URL: `https://telescope.ac/api/files/branding_icons`
- Auth: none declared

Uploads a branding icon; use the returned file id as customization.branding_icon_file_id.

**API credit cost:** 5

## Headers

- `Authorization` string

## Request body `multipart/form-data`

- object
  - `file` string, binary, required: Image file to upload.

## Response `200`

OK

- UploadFileOutputBody
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `file` File, required
    - `created_at` string, date-time, nullable, required
    - `deleted_at` string, date-time
    - `id` string, required
    - `link` string, required
    - `publication_id` string, required
    - `server_url` string, required
    - `size` integer, required
    - `type` string, required
    - `user_id` string, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/telescope/apis/telescope-api.md) - [All operations](https://skmtc.dev/telescope/apis/telescope-api/llms.txt) - [OpenAPI document](https://skmtc.dev/telescope/apis/telescope-api/revisions/e4bd44d7f2b0?raw)