Upload file

POST /v1/api/files Requires studies:write

Upload background material for Create a study or Update a study. The returned file_id has no effect by itself; include it in file_ids when creating or updating the study. Supports PDF, DOCX, TXT, and MD.

Request body multipart/form-data

file

string required

Responses

200 Successful Response

file_id

string <uuid> required

Use as a file_ids entry when creating or updating a study.

filename

string required

Original filename as uploaded.

byte_size

integer required

Stored size in bytes.

extracted

boolean required

Whether text was parsed out of the file. False for empty or binary types that carry no extractable content.

422 Validation Error

ValidationError[]

cURL

curl -X POST 'https://api.heyjuno.co/v1/api/files' \
  -H 'Authorization: Bearer $JUNO_API_KEY' \
  -F 'file=@document.pdf'

Example response

{
  "file_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "filename": "string",
  "byte_size": 0,
  "extracted": true
}