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

Player

Download schema

Read, draft, and publish player configuration.


List players

GET
https://api.atomicplayer.ai
/v1/player-config/manage/workspace/{workspaceId}

Returns the player configs in a workspace. Required scope: read.

List players › path Parameters

workspaceId
​string · uuid · required

workspaceId

List players › Responses

List players

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/player-config/manage/workspace/{workspaceId}
curl --request GET \ --url https://api.atomicplayer.ai/v1/player-config/manage/workspace/:workspaceId
Example Responses
{ "success": true, "data": { "players": [ { "id": "00000000-0000-4000-8000-000000000030", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "videoId": "00000000-0000-4000-8000-000000000001", "publishedVersion": 3 } ] }, "error": null }
json
application/json

Get a player

GET
https://api.atomicplayer.ai
/v1/player-config/manage/{playerId}

Returns the draft and the published player config. Required scope: read.

Get a player › path Parameters

playerId
​string · uuid · required

playerId

Get a player › Responses

Get a player

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/player-config/manage/{playerId}
curl --request GET \ --url https://api.atomicplayer.ai/v1/player-config/manage/:playerId
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000030", "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "videoId": "00000000-0000-4000-8000-000000000001", "publishedVersion": 3 }, "error": null }
json
application/json

Create a player

POST
https://api.atomicplayer.ai
/v1/player-config

Creates a draft player for a video. Publish it before the embed uses it. Required scope: write.

Create a player › Request Body

workspaceId
​string
videoId
​string

Create a player › Responses

Create a player

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

Update a player draft

PATCH
https://api.atomicplayer.ai
/v1/player-config/{playerId}/draft

Saves draft changes. The live embed keeps the published version. Required scope: write.

Update a player draft › path Parameters

playerId
​string · uuid · required

playerId

Update a player draft › Request Body

​object

Update a player draft › Responses

Update a player draft

success
​boolean · enum · required
Enum values:
​object · required
error
​required
PATCH/v1/player-config/{playerId}/draft
curl --request PATCH \ --url https://api.atomicplayer.ai/v1/player-config/:playerId/draft \ --header 'Content-Type: application/json' \ --data ' { "appearance": { "primaryColor": "#ff7a1a" } } '
Example Request Body
{ "appearance": { "primaryColor": "#ff7a1a" } }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000030", "publishedVersion": 3 }, "error": null }
json
application/json

Publish a player

POST
https://api.atomicplayer.ai
/v1/player-config/{playerId}/publish

Copies the draft to the live embed and increments publishedVersion. Required scope: write.

Publish a player › path Parameters

playerId
​string · uuid · required

playerId

Publish a player › Responses

Publish a player

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/player-config/{playerId}/publish
curl --request POST \ --url https://api.atomicplayer.ai/v1/player-config/:playerId/publish
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000030", "publishedVersion": 4 }, "error": null }
json
application/json

TagsAnalytics