Upload file

Upload a file to a project’s Convex storage. Returns the file ID and a serving URL.

POST /v1/projects/{id}/files

Upload file

cURL

curl --request POST \
  --url https://api.vly.ai/v1/projects/{id}/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form file=@example-file

201

{
  "id": "<string>",
  "url": "<string>",
  "size": 123,
  "mime": "<string>"
}

Multipart form upload. The file is stored in the project’s Convex file storage and is immediately referenceable from the project’s code.

Maximum file size: 100 MB. For larger uploads, use the direct-to-Convex upload pattern instead.

Authorizations

Authorization · string · header · required

Workspace-scoped API key. Generate from Workspace settings → API keys.

Path Parameters

id · string · required

Body

multipart/form-data

file · file · required

path · string

Example:

"/uploads/avatars/me.png"

Response

201 - application/json

Created

id · string

url · string<uri>

size · integer

mime · string