API

dosya.dev REST API

Everything you can do in the dashboard, you can do via the API. Upload terabytes, manage workspaces, and generate share links — all programmatically.

Get API Key View SDKs

Getting Started

Authentication

Base URL & API Key

# Base URL
https://dosya.dev/api

# All requests require an API key in the header
Authorization: Bearer dos_your-api-key

# Example: List your workspaces
$ curl https://dosya.dev/api/workspaces \
    -H "Authorization: Bearer dos_your-api-key"

Endpoints

API Reference

Click any endpoint to see its example request and response.

Files

POST /api/upload/init Initialize a file upload

{
  "file_name": "project-final.mp4",
  "file_size": 214748364800,
  "workspace_id": "ws_abc123",
  "mime_type": "video/mp4"
}

201 Created

{
  "session_id": "sess_7f3k9x2m",
  "workspace": "ws_abc123",
  "file_name": "project-final.mp4",
  "chunk_size": 10485760,
  "total_chunks": 21,
  "expires_at": "2026-04-22T11:30:00Z"
}

curl -X POST https://dosya.dev/api/upload/init \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "project-final.mp4",
    "file_size": 214748364800,
    "workspace_id": "ws_abc123",
    "mime_type": "video/mp4"
  }'

POST /api/upload/:sessionId Upload a chunk

Binary chunk data

Headers:
  Content-Type: application/octet-stream
  X-Chunk-Index: 3

200 OK

{
  "session_id": "sess_7f3k9x2m",
  "chunk_index": 3,
  "received_bytes": 10485760,
  "progress": 14.3,
  "status": "uploading"
}

curl -X POST https://dosya.dev/api/upload/sess_7f3k9x2m \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/octet-stream" \
  -H "X-Chunk-Index: 3" \
  --data-binary @chunk_003.bin

GET /api/files/:id Get file metadata

No request body required.

Query parameters (optional):
  include=versions    Include version history

200 OK

{
  "id": "file_8xk2m9p4",
  "name": "project-final.mp4",
  "size": 214748364800,
  "mime_type": "video/mp4",
  "workspace": "ws_abc123",
  "region": "eu-central-2",
  "checksum": "sha256:a1b2c3d4...",
  "created_at": "2026-04-14T10:30:00Z",
  "download_url": "https://cdn.dosya.dev/file_8xk2m9p4",
  "encryption": "aes-256-gcm"
}

curl https://dosya.dev/api/files/file_8xk2m9p4 \
  -H "Authorization: Bearer dos_your-api-key"

GET /api/files/:id/download Download a file

No request body required.

200 OK

{
  "url": "https://cdn.dosya.dev/file_8xk2m9p4?token=tmp_x9...",
  "expires_at": "2026-04-22T11:00:00Z",
  "file_name": "project-final.mp4",
  "size": 214748364800,
  "mime_type": "video/mp4"
}

curl https://dosya.dev/api/files/file_8xk2m9p4/download \
  -H "Authorization: Bearer dos_your-api-key"

DELETE /api/files/:id Delete a file

No request body required.

200 OK

{
  "id": "file_8xk2m9p4",
  "deleted": true
}

curl -X DELETE https://dosya.dev/api/files/file_8xk2m9p4 \
  -H "Authorization: Bearer dos_your-api-key"

PATCH /api/files/:id Rename or move a file

{
  "name": "final-cut-v2.mp4",
  "path": "/videos/final-cut-v2.mp4"
}

200 OK

{
  "id": "file_8xk2m9p4",
  "name": "final-cut-v2.mp4",
  "workspace": "ws_abc123",
  "path": "/videos/final-cut-v2.mp4",
  "updated_at": "2026-04-22T10:15:00Z"
}

curl -X PATCH https://dosya.dev/api/files/file_8xk2m9p4 \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "final-cut-v2.mp4",
    "path": "/videos/final-cut-v2.mp4"
  }'

GET /api/files/:id/versions List file versions

No request body required.

Query parameters (optional):
  limit=10    Max versions to return
  cursor=...  Pagination cursor

200 OK

{
  "file_id": "file_8xk2m9p4",
  "versions": [
    {
      "version": 2,
      "size": 214748364800,
      "checksum": "sha256:a1b2c3d4...",
      "created_at": "2026-04-14T10:30:00Z"
    },
    {
      "version": 1,
      "size": 198132736000,
      "checksum": "sha256:e5f6g7h8...",
      "created_at": "2026-04-12T08:00:00Z"
    }
  ]
}

curl https://dosya.dev/api/files/file_8xk2m9p4/versions \
  -H "Authorization: Bearer dos_your-api-key"

Workspaces

POST /api/workspaces Create a workspace

{
  "name": "Marketing Assets",
  "region": "eu-central-2"
}

201 Created

{
  "id": "ws_n4x8k2pm",
  "name": "Marketing Assets",
  "created_at": "2026-04-22T10:00:00Z",
  "storage_used": 0,
  "file_count": 0,
  "region": "eu-central-2"
}

curl -X POST https://dosya.dev/api/workspaces \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Assets",
    "region": "eu-central-2"
  }'

GET /api/workspaces List your workspaces

No request body required.

200 OK

{
  "workspaces": [
    {
      "id": "ws_abc123",
      "name": "Engineering",
      "storage_used": 536870912000,
      "file_count": 142,
      "created_at": "2026-01-10T09:00:00Z"
    },
    {
      "id": "ws_n4x8k2pm",
      "name": "Marketing Assets",
      "storage_used": 107374182400,
      "file_count": 38,
      "created_at": "2026-04-22T10:00:00Z"
    }
  ]
}

curl https://dosya.dev/api/workspaces \
  -H "Authorization: Bearer dos_your-api-key"

GET /api/workspaces/:id Get workspace details

No request body required.

200 OK

{
  "id": "ws_abc123",
  "name": "Engineering",
  "storage_used": 536870912000,
  "file_count": 142,
  "member_count": 8,
  "region": "eu-central-2",
  "created_at": "2026-01-10T09:00:00Z"
}

curl https://dosya.dev/api/workspaces/ws_abc123 \
  -H "Authorization: Bearer dos_your-api-key"

GET /api/workspaces/:id/files List files in workspace

No request body required.

Query parameters (optional):
  limit=50    Max files to return (max 200)
  cursor=...  Pagination cursor
  sort=name   Sort by: name, size, created_at

200 OK

{
  "workspace_id": "ws_abc123",
  "files": [
    {
      "id": "file_8xk2m9p4",
      "name": "project-final.mp4",
      "size": 214748364800,
      "mime_type": "video/mp4",
      "created_at": "2026-04-14T10:30:00Z"
    },
    {
      "id": "file_2jd7m4qr",
      "name": "design-system.fig",
      "size": 48234496,
      "mime_type": "application/octet-stream",
      "created_at": "2026-04-13T15:20:00Z"
    }
  ],
  "has_more": true,
  "cursor": "cur_xk29m..."
}

curl https://dosya.dev/api/workspaces/ws_abc123/files \
  -H "Authorization: Bearer dos_your-api-key"

DELETE /api/workspaces/:id Delete a workspace

No request body required.

200 OK

{
  "id": "ws_n4x8k2pm",
  "deleted": true
}

curl -X DELETE https://dosya.dev/api/workspaces/ws_n4x8k2pm \
  -H "Authorization: Bearer dos_your-api-key"

Sharing

POST /api/shares Create a share link

{
  "file_id": "file_8xk2m9p4",
  "expires_in": "30d",
  "password": null,
  "max_downloads": null
}

201 Created

{
  "id": "share_9xm2k4p7",
  "file_id": "file_8xk2m9p4",
  "url": "https://dosya.dev/s/9xm2k4p7",
  "password_protected": false,
  "expires_at": "2026-05-22T10:00:00Z",
  "max_downloads": null,
  "download_count": 0,
  "created_at": "2026-04-22T10:00:00Z"
}

curl -X POST https://dosya.dev/api/shares \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "file_8xk2m9p4",
    "expires_in": "30d",
    "password": null,
    "max_downloads": null
  }'

GET /api/shares List active share links

No request body required.

200 OK

{
  "shares": [
    {
      "id": "share_9xm2k4p7",
      "file_id": "file_8xk2m9p4",
      "file_name": "project-final.mp4",
      "url": "https://dosya.dev/s/9xm2k4p7",
      "download_count": 12,
      "expires_at": "2026-05-22T10:00:00Z"
    },
    {
      "id": "share_3kp7n2xm",
      "file_id": "file_2jd7m4qr",
      "file_name": "design-system.fig",
      "url": "https://dosya.dev/s/3kp7n2xm",
      "download_count": 5,
      "expires_at": null
    }
  ]
}

curl https://dosya.dev/api/shares \
  -H "Authorization: Bearer dos_your-api-key"

DELETE /api/shares/:id Revoke a share link

No request body required.

200 OK

{
  "id": "share_9xm2k4p7",
  "revoked": true
}

curl -X DELETE https://dosya.dev/api/shares/share_9xm2k4p7 \
  -H "Authorization: Bearer dos_your-api-key"

PATCH /api/shares/:id Update link settings

{
  "password": "s3cret",
  "expires_in": "60d",
  "max_downloads": 100
}

200 OK

{
  "id": "share_9xm2k4p7",
  "password_protected": true,
  "expires_at": "2026-06-01T00:00:00Z",
  "max_downloads": 100,
  "updated_at": "2026-04-22T10:30:00Z"
}

curl -X PATCH https://dosya.dev/api/shares/share_9xm2k4p7 \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "password": "s3cret",
    "expires_in": "60d",
    "max_downloads": 100
  }'

Members

POST /api/team/invite Invite a member

{
  "email": "alice@example.com",
  "role": "editor",
  "workspace_id": "ws_abc123"
}

201 Created

{
  "id": "inv_4m8x2kp9",
  "email": "alice@example.com",
  "role": "editor",
  "workspace_id": "ws_abc123",
  "status": "pending",
  "invited_at": "2026-04-22T10:00:00Z",
  "expires_at": "2026-04-29T10:00:00Z"
}

curl -X POST https://dosya.dev/api/team/invite \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "alice@example.com",
    "role": "editor",
    "workspace_id": "ws_abc123"
  }'

GET /api/team/members List members

No request body required.

200 OK

{
  "members": [
    {
      "uid": "usr_xk2m9p4n",
      "email": "alice@example.com",
      "name": "Alice Chen",
      "role": "editor",
      "joined_at": "2026-02-15T09:00:00Z"
    },
    {
      "uid": "usr_7j3n8m2k",
      "email": "bob@example.com",
      "name": "Bob Rivera",
      "role": "viewer",
      "joined_at": "2026-03-20T14:00:00Z"
    }
  ]
}

curl https://dosya.dev/api/team/members \
  -H "Authorization: Bearer dos_your-api-key"

PATCH /api/team/members/:uid Update member role

{
  "role": "editor"
}

200 OK

{
  "uid": "usr_7j3n8m2k",
  "email": "bob@example.com",
  "role": "editor",
  "updated_at": "2026-04-22T10:15:00Z"
}

curl -X PATCH https://dosya.dev/api/team/members/usr_7j3n8m2k \
  -H "Authorization: Bearer dos_your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "editor"
  }'

DELETE /api/team/members/:uid Remove a member

No request body required.

200 OK

{
  "uid": "usr_7j3n8m2k",
  "removed": true
}

curl -X DELETE https://dosya.dev/api/team/members/usr_7j3n8m2k \
  -H "Authorization: Bearer dos_your-api-key"

Limits

Rate limits

1,000 Requests per minute (Free)

10,000 Requests per minute (Paid)

Unlimited Upload bandwidth

dosya.dev REST API

Authentication

API Reference

Rate limits

Start integrating today