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

Folders

Download schema

Organize videos into folders.


List folders

GET
https://api.atomicplayer.ai
/v1/video-folders

Returns the folders in a workspace. Required scope: read.

List folders › query Parameters

workspaceId
​string · uuid · required

Workspace id.

List folders › Responses

List folders

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/video-folders
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/video-folders?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "folders": [ { "id": "00000000-0000-4000-8000-000000000010", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "Campaigns", "parentId": null } ] }, "error": null }
json
application/json

Create a folder

POST
https://api.atomicplayer.ai
/v1/video-folders

parentId nests the folder. Omit it for a root folder. Required scope: write.

Create a folder › Request Body

workspaceId
​string
name
​string
parentId
​

Create a folder › Responses

Create a folder

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/video-folders
curl --request POST \ --url https://api.atomicplayer.ai/v1/video-folders \ --header 'Content-Type: application/json' \ --data ' { "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "Campaigns", "parentId": null } '
Example Request Body
{ "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "Campaigns", "parentId": null }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000010", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "Campaigns", "parentId": null }, "error": null }
json
application/json

VideosTags