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

Webhooks

Download schema

Subscribe a public HTTPS URL to signed account events.


List webhook events

GET
https://api.atomicplayer.ai
/v1/webhooks/events

The event names a subscription can include. Required scope: webhooks.

List webhook events › Responses

List webhook events

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/events
curl --request GET \ --url https://api.atomicplayer.ai/v1/webhooks/events
Example Responses
{ "success": true, "data": { "events": [ "video.viewed", "video.completed", "video.uploaded" ] }, "error": null }
json
application/json

List webhooks

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

Returns the endpoints in a workspace. Secrets are not included. Required scope: webhooks.

List webhooks › query Parameters

workspaceId
​string · uuid · required

Workspace id.

List webhooks › Responses

List webhooks

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/webhooks?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "webhooks": [ { "id": "00000000-0000-4000-8000-000000000040", "name": "CRM", "url": "https://example.com/atomicplayer", "events": [ "video.viewed" ], "status": "active" } ] }, "error": null }
json
application/json

Create a webhook

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

events is a list of catalog names, or ["*"] for every event. The signing secret is returned once. Required scope: webhooks.

Create a webhook › Request Body

workspaceId
​string
name
​string
url
​string
events
​string[]

Create a webhook › Responses

Create a webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/webhooks
curl --request POST \ --url https://api.atomicplayer.ai/v1/webhooks \ --header 'Content-Type: application/json' \ --data ' { "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "CRM", "url": "https://example.com/atomicplayer", "events": [ "video.viewed", "video.completed" ] } '
Example Request Body
{ "workspaceId": "ddaf7e61-1a65-4d59-9f94-d706fc53131a", "name": "CRM", "url": "https://example.com/atomicplayer", "events": [ "video.viewed", "video.completed" ] }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000040", "secret": "whsec_…", "status": "active" }, "error": null }
json
application/json

Get a webhook

GET
https://api.atomicplayer.ai
/v1/webhooks/{id}

Returns one endpoint without its secret. Required scope: webhooks.

Get a webhook › path Parameters

id
​string · uuid · required

id

Get a webhook › Responses

Get a webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/{id}
curl --request GET \ --url https://api.atomicplayer.ai/v1/webhooks/:id
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000040", "name": "CRM", "status": "active", "events": [ "video.viewed" ] }, "error": null }
json
application/json

Delete a webhook

DELETE
https://api.atomicplayer.ai
/v1/webhooks/{id}

Stops deliveries to this endpoint. Required scope: webhooks.

Delete a webhook › path Parameters

id
​string · uuid · required

id

Delete a webhook › Responses

Delete a webhook

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

Update a webhook

PATCH
https://api.atomicplayer.ai
/v1/webhooks/{id}

Changes the name, URL, events, or status. status is active or paused. Required scope: webhooks.

Update a webhook › path Parameters

id
​string · uuid · required

id

Update a webhook › Request Body

status
​string

Update a webhook › Responses

Update a webhook

success
​boolean · enum · required
Enum values:
​object · required
error
​required
PATCH/v1/webhooks/{id}
curl --request PATCH \ --url https://api.atomicplayer.ai/v1/webhooks/:id \ --header 'Content-Type: application/json' \ --data ' { "status": "paused" } '
Example Request Body
{ "status": "paused" }
json
application/json
Example Responses
{ "success": true, "data": { "id": "00000000-0000-4000-8000-000000000040", "status": "paused" }, "error": null }
json
application/json

List deliveries

GET
https://api.atomicplayer.ai
/v1/webhooks/{id}/deliveries

Recent delivery attempts for one endpoint. Required scope: webhooks.

List deliveries › path Parameters

id
​string · uuid · required

id

List deliveries › Responses

List deliveries

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/{id}/deliveries
curl --request GET \ --url https://api.atomicplayer.ai/v1/webhooks/:id/deliveries
Example Responses
{ "success": true, "data": { "deliveries": [ { "id": "del_123", "eventType": "video.viewed", "status": "succeeded" } ] }, "error": null }
json
application/json

Send a test event

POST
https://api.atomicplayer.ai
/v1/webhooks/{id}/test

Delivers one sample event to the endpoint. Required scope: webhooks.

Send a test event › path Parameters

id
​string · uuid · required

id

Send a test event › Responses

Send a test event

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/webhooks/{id}/test
curl --request POST \ --url https://api.atomicplayer.ai/v1/webhooks/:id/test
Example Responses
{ "success": true, "data": { "delivered": true }, "error": null }
json
application/json

Rotate the signing secret

POST
https://api.atomicplayer.ai
/v1/webhooks/{id}/rotate-secret

Returns a new secret once. The previous secret stops verifying. Required scope: webhooks.

Rotate the signing secret › path Parameters

id
​string · uuid · required

id

Rotate the signing secret › Responses

Rotate the signing secret

success
​boolean · enum · required
Enum values:
​object · required
error
​required
POST/v1/webhooks/{id}/rotate-secret
curl --request POST \ --url https://api.atomicplayer.ai/v1/webhooks/:id/rotate-secret
Example Responses
{ "success": true, "data": { "secret": "whsec_…" }, "error": null }
json
application/json

Webhook stats

GET
https://api.atomicplayer.ai
/v1/webhooks/stats

Delivery health for the workspace. Required scope: webhooks.

Webhook stats › query Parameters

workspaceId
​string · uuid · required

Workspace id.

Webhook stats › Responses

Webhook stats

success
​boolean · enum · required
Enum values:
​object · required
error
​required
GET/v1/webhooks/stats
curl --request GET \ --url 'https://api.atomicplayer.ai/v1/webhooks/stats?workspaceId=%3Cstring%3E'
Example Responses
{ "success": true, "data": { "active": 2, "failing": 0 }, "error": null }
json
application/json

AnalyticsAPI keys