Files

5 endpoints.

Paths are relative to the base URL for your environment. Unless marked otherwise, every request needs an Authorization: Bearer header.

POST/files

File Create (Presigned URL)

Request body

json

{
  "folder": "test-sls",
  "originalFileName": "test.jpg",
  "contentType": "image/jpeg"
}

Response fields

Asserted by the API’s own test suite.

fileKeys3ObjectKeyuploadUrlexpiresIn

PUT{{aws_presigned_url}}Not a Movik host

File Upload (PUT to S3)

This request goes to the pre-signed S3 URL returned by POST /files, not to the Movik API. Send the file bytes as the raw body and do not attach an Authorization header — the signature in the URL is the authorization, and adding a bearer token makes S3 reject the upload.

POST/files/confirm

File Confirm

Request body

json

{
  "Records": [
    {
      "s3": {
        "bucket": {
          "name": "{{files_bucket}}"
        },
        "object": {
          "key": "{{s3_object_key}}"
        }
      }
    }
  ]
}

Response fields

Asserted by the API’s own test suite.

status

GET/files/{file_key}

File Get

Path parameters

{file_key} — required

Response fields

Asserted by the API’s own test suite.

downloadUrl

DELETE/files/{file_key}

File Delete

Path parameters

{file_key} — required

Request body

json

{
  "deleteReason": "test cleanup"
}

Response fields

Asserted by the API’s own test suite.

fileKeystatusdeleteAfterEpochretentionDays