Skip to navigation
API žinynasFiles

Upload a file

View as Markdown

Send the raw bytes as the body with their Content-Type (PDF, image, XML…) and the name in filename. Then turn the file into a document with POST /documents. Up to 48 MB; unused files are deleted after a day.

Authentication

AuthorizationBearer

Skaitra API key (skt_…).

OR
AuthorizationBearer

OAuth 2.1 access token issued for the Skaitra resource (/mcp); see /.well-known/oauth-protected-resource.

Headers

Idempotency-KeystringOptional<=200 characters

Any unique value; a retry with the same key returns the first result.

Query parameters

filenamestringRequired1-255 characters
The file's name, with its extension.

Response

OK
idstring
filenamestring
mimeTypestring
sizeBytesinteger-9007199254740991-9007199254740991
sha256string
createdAtstring
expiresAtstring
documentIdstring or null

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
422
Unprocessable Entity Error
428
Precondition Error