Files API

The Files API allows you to upload and manage video files for processing with Move AI.

Upload a File

Upload a video file to be processed by the Move API.

curl -X POST https://api.move.ai/v1/files \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@video.mp4" \
  -F "name=my_video"

Request Parameters

Parameter	Type	Required	Description
file	File	Yes	The video file to upload
name	String	No	A custom name for the file

Response

{
  "id": "file_123456789",
  "name": "my_video",
  "status": "uploaded",
  "created_at": "2023-01-01T00:00:00Z",
  "size": 1048576
}

Get file details

Retrieve information about a specific file.

curl -X GET https://api.move.ai/v1/files/file_123456789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "id": "file_123456789",
  "name": "my_video",
  "status": "processed",
  "created_at": "2023-01-01T00:00:00Z",
  "size": 1048576,
  "duration": 30.5,
  "resolution": "1920x1080"
}

List files

Get a list of all your uploaded files.

curl -X GET https://api.move.ai/v1/files \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters

Parameter	Type	Description
limit	Integer	Number of files to return (default: 20, max: 100)
offset	Integer	Number of files to skip
status	String	Filter by file status

Response

{
  "files": [
    {
      "id": "file_123456789",
      "name": "my_video",
      "status": "processed",
      "created_at": "2023-01-01T00:00:00Z",
      "size": 1048576
    }
  ],
  "total": 1,
  "limit": 20,
  "offset": 0
}

Delete a File

Delete a file from your account.

curl -X DELETE https://api.move.ai/v1/files/file_123456789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "message": "File deleted successfully"
}

File statuses

Status	Description
uploading	File is being uploaded
uploaded	File upload completed
processing	File is being processed
processed	File processing completed
failed	File processing failed
deleted	File has been deleted

Supported file formats

• MP4 (H.264)
• MOV (H.264)
• AVI
• WebM

File size limits

• Free Tier: 100MB per file
• Developer Plan: 500MB per file
• Professional Plan: 2GB per file
• Enterprise Plan: Custom limits

Next steps

• Jobs API - Create processing jobs
• Takes API - Retrieve motion capture data
• Quick Start Guide