---
title: "Generate attachment upload URL"
method: POST
path: "/v1/attachments/upload-url"
tags: ["v1 - Attachments"]
---

# Generate attachment upload URL

`POST /v1/attachments/upload-url`

## Request

- Base URL: `https://light.inc` (the document declares no server; this is the origin it was published from)
- URL: `https://light.inc/v1/attachments/upload-url`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

Generates a secure upload URL for attachment files

## Request body

- ExternalUploadAttachmentRequestV1Model
  - `resourceId` string, uuid
  - `fileName` string
  - `contentType` string

## Response `default`

default response

- ExternalAttachmentUploadUrlResponseV1Model
  - `uploadUrl` string, url
  - `key` string
  - `metadata` object, nullable

---

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