AtomicPlayerAtomicPlayer
atomicplayer.ai
  • English
  • Español
  • Português
AtomicPlayer
  • Website
  • Dashboard
API docs
  • Introduction
  • Authentication
  • API reference

© 2026 AtomicPlayer

Information
Videos
    List videosgetCreate a videopostGet a videogetDelete a videodeleteUpdate a videopatchCreate an upload URLpostGet upload statusget
Folders
    List foldersgetCreate a folderpost
Tags
    List tagsgetCreate a tagpostReplace video tagsput
Player
    List playersgetGet a playergetCreate a playerpostUpdate a player draftpatchPublish a playerpost
Analytics
    Analytics overviewgetVideo analyticsgetRetention curvegetPlayback funnelgetRevenuegetCohortsgetAudiencegetLive viewersgetReplay sessionsgetVideo summariesget
Webhooks
    List webhook eventsgetList webhooksgetCreate a webhookpostGet a webhookgetDelete a webhookdeleteUpdate a webhookpatchList deliveriesgetSend a test eventpostRotate the signing secretpostWebhook statsget
API keys
    List API keysgetCreate an API keypostRevoke an API keydeleteUpdate an API keypatch
Schemas
AtomicPlayer API
AtomicPlayer API

Videos

Download schema

Create videos, request an upload URL, and read processing status.


List videos

GET
https://api.atomicplayer.ai
/v1/videos

Returns the videos in a workspace. Pass tagId to keep one tag. Required scope: read.

List videos › query Parameters

workspaceId
​string · uuid · required

Workspace id.

tagId
​string · uuid

Only videos with this tag.

List videos › Responses

List videos

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/videos
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/videos?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "videos": [ { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "ready", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" } ] }, "error": null }
json
application/json

Create a video

POST
https://api.atomicplayer.ai
/v1/videos

Creates a video record. The file is uploaded separately with the upload URL. Required scope: write.

Create a video › Request Body

workspaceId
​string
title
​string

Create a video › Responses

Create a video

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/videos
curl --request POST \ --url https://api.atomicplayer.ai/v1/videos \ --header 'Content-Type: application/json' \ --data ' { "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "title": "Product launch VSL" } '
Example Request Body
{ "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "title": "Product launch VSL" }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "created", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" }, "error": null }
json
application/json

Get a video

GET
https://api.atomicplayer.ai
/v1/videos/{videoId}

Returns one video, including playback URLs once it is ready. Required scope: read.

Get a video › path Parameters

videoId
​string · uuid · required

videoId

Get a video › Responses

Get a video

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/videos/{videoId}
curl --request GET \ --url https://api.atomicplayer.ai/v1/videos/:videoId
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "ready", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" }, "error": null }
json
application/json

Delete a video

DELETE
https://api.atomicplayer.ai
/v1/videos/{videoId}

Deletes the video from the workspace. Required scope: write.

Delete a video › path Parameters

videoId
​string · uuid · required

videoId

Delete a video › Responses

Delete a video

success
​boolean · enum · required
Enum values:
​object · required
error
​required
DELETE/v1/videos/{videoId}
curl --request DELETE \ --url https://api.atomicplayer.ai/v1/videos/:videoId
Example Responses
{ "success": true, "data": { "deleted": true }, "error": null }
json
application/json

Update a video

PATCH
https://api.atomicplayer.ai
/v1/videos/{videoId}

Changes fields such as the title or folder. Required scope: write.

Update a video › path Parameters

videoId
​string · uuid · required

videoId

Update a video › Request Body

title
​string
folderId
​string

Update a video › Responses

Update a video

success
​boolean · enum · required
Enum values:
​object · required
error
​required
PATCH/v1/videos/{videoId}
curl --request PATCH \ --url https://api.atomicplayer.ai/v1/videos/:videoId \ --header 'Content-Type: application/json' \ --data ' { "title": "Product launch VSL", "folderId": "00000000-0000-4000-8000-000000000010" } '
Example Request Body
{ "title": "Product launch VSL", "folderId": "00000000-0000-4000-8000-000000000010" }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "folderId": "00000000-0000-4000-8000-000000000010", "title": "Product launch VSL", "status": "ready", "durationSec": 186, "width": 1920, "height": 1080, "tagIds": [ "00000000-0000-4000-8000-000000000020" ], "posterUrl": "https://cdn.example.com/abc/thumbnail.jpg", "hlsUrl": "https://cdn.example.com/abc/playlist.m3u8", "createdAt": "2026-07-15T10:22:00.000Z", "updatedAt": "2026-07-15T10:28:00.000Z" }, "error": null }
json
application/json

Create an upload URL

POST
https://api.atomicplayer.ai
/v1/videos/{videoId}/upload-url

Returns a one-time upload target. Send the file there, then poll the status route. Required scope: write.

Create an upload URL › path Parameters

videoId
​string · uuid · required

videoId

Create an upload URL › Responses

Create an upload URL

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/videos/{videoId}/upload-url
curl --request POST \ --url https://api.atomicplayer.ai/v1/videos/:videoId/upload-url
Example Responses
{ "success": true, "data": { "url": "https://video.bunnycdn.com/tusupload", "headers": { "AuthorizationSignature": "…" } }, "error": null }
json
application/json

Get upload status

GET
https://api.atomicplayer.ai
/v1/videos/{videoId}/status

status moves from uploading to processing and then ready. Required scope: read.

Get upload status › path Parameters

videoId
​string · uuid · required

videoId

Get upload status › Responses

Get upload status

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/videos/{videoId}/status
curl --request GET \ --url https://api.atomicplayer.ai/v1/videos/:videoId/status
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000001", "status": "processing" }, "error": null }
json
application/json

Folders