---
title: "Upload a space cover image"
method: POST
path: "/files/space_cover_images"
tags: ["File"]
---

# Upload a space cover image

`POST /files/space_cover_images`

## Request

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

Uploads a space cover image; use the returned file id as customization.image_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)