Wistia

Wistia Push Devices API

The Push Devices API from Wistia — 2 operation(s) for push devices.

GitHub OpenAPI

Operations 2

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /devices Register a device for push notifications · Register Push Device #
Ask an LLM
“How do I register a device to get push notifications about comments and views?”
“Which APNs environment do I specify when registering a device token?”
Tell an agent
Register device token {device_token} for app {bundle_id} in {environment}.
Enable push notifications for device {device_token}, bundle {bundle_id}, environment {environment}.
DELETE /devices/{deviceToken} Unregister a push notification device · Unregister Push Device #
Ask an LLM
“How do I stop push notifications going to a device?”
“Can I unregister a device token I registered earlier?”
Tell an agent destructive · confirm first
Unregister device {deviceToken}.
Stop sending notifications to device token {deviceToken}.

Documentation

📖
Documentation
https://docs.wistia.com/reference/getting-started-with-the-data-api
📖
GettingStarted
https://docs.wistia.com/docs/making-api-requests
📖
Authentication
https://docs.wistia.com/docs/authenticating-with-oauth2
📖
APIReference
https://docs.wistia.com/reference
📖
Documentation
https://docs.wistia.com/docs/migration-from-v1-guide
📖
Authentication
https://artifacts.apis.io/wistia/authentication/wistia-authentication.yml
📖
RateLimits
https://artifacts.apis.io/wistia/rate-limits/wistia-rate-limits.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/wistia/openapi/wistia-push-devices-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://artifacts.apis.io/wistia/scopes/wistia-scopes.yml
🔗
ErrorCatalog
https://artifacts.apis.io/wistia/errors/wistia-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/wistia/data-model/wistia-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/wistia:wistia-push-devices-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

wistia-push-devices-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Data Push Devices API
  description: Wistia Data API
  version: edge-version
servers:
- url: https://api.wistia.com/modern
tags:
- name: Push Devices
  x-wistia-mcp-toolsets: account
  x-displayName: Push Devices
paths:
  /devices:
    post:
      x-readme-hidden: true
      x-wistia-mcp-ignore: true
      summary: Register Push Device
      x-speakeasy-group: pushDevices
      x-speakeasy-name-override: create
      description: 'Registers a push notification device token for the current contact. Used by

        the Wistia desktop app to receive activity notifications (new comments and

        views) for media created via the app. Re-registering an existing

        token updates its registration in place.'
      tags:
      - Push Devices
      requestBody:
        required: true
        content:
          application/json:
            schema:
              unevaluatedProperties: false
              type: object
              properties:
                device_token:
                  description: The APNs device token, hex encoded.
                  type: string
                  examples:
                  - 6a41c6f2e5b1d3f4a7c8e9b0d1f2a3c4e5b6d7f8a9c0b1d2e3f4a5b6c7d8e9f0
                bundle_id:
                  description: The app bundle identifier the token was issued for.
                  type: string
                  examples:
                  - com.wistia.glass
                environment:
                  description: The APNs environment the token belongs to.
                  type: string
                  enum:
                  - sandbox
                  - production
              required:
              - device_token
              - bundle_id
              - environment
      responses:
        '201':
          description: Push device registered successfully.
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                description: 'A registered push notification device token for the Wistia desktop app.

                  Used to deliver activity notifications (new comments and views)

                  for media created via the desktop app.

                  '
                properties:
                  device_token:
                    description: The APNs device token, hex encoded.
                    type: string
                    examples:
                    - 6a41c6f2e5b1d3f4a7c8e9b0d1f2a3c4e5b6d7f8a9c0b1d2e3f4a5b6c7d8e9f0
                  bundle_id:
                    description: The app bundle identifier the token was issued for.
                    type: string
                    examples:
                    - com.wistia.glass
                  environment:
                    description: The APNs environment the token belongs to.
                    type: string
                    enum:
                    - sandbox
                    - production
                  created_at:
                    description: The date the device was first registered.
                    type: string
                    format: date-time
                    examples:
                    - '2026-07-07T18:47:39+00:00'
                  cursor:
                    description: A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.
                    type:
                    - string
                    - 'null'
                required:
                - device_token
                - bundle_id
                - environment
                - created_at
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    description: Error message detailing the reason for the bad request.
                    type: string
                    examples:
                    - Bad request
                  errors:
                    description: Array of error messages detailing the reasons for the bad request.
                    type: array
                    items:
                      type: string
        '401':
          description: Unauthorized, invalid or missing token
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  code:
                    description: A machine-readable identifier for the specific authorization failure.
                    type: string
                    enum:
                    - unauthorized_credentials
                    - account_inactive
                    - unauthorized_scope
                    - unauthorized_params
                  error:
                    type: string
                    examples:
                    - Invalid credentials.
        '403':
          description: Forbidden, token is valid but account does not have access to feature
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Webinars are not available on your current plan
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Internal server error
      security:
      - BearerAuth: []
      operationId: postDevices
      x-operation-id-source: derived
  /devices/{deviceToken}:
    delete:
      x-readme-hidden: true
      x-wistia-mcp-ignore: true
      summary: Unregister Push Device
      x-speakeasy-group: pushDevices
      x-speakeasy-name-override: delete
      description: 'Unregisters a push notification device token for the current contact, so no

        further activity notifications are delivered to that device.'
      tags:
      - Push Devices
      parameters:
      - name: deviceToken
        in: path
        description: The APNs device token to unregister, hex encoded.
        required: true
        schema:
          type: string
          examples:
          - 6a41c6f2e5b1d3f4a7c8e9b0d1f2a3c4e5b6d7f8a9c0b1d2e3f4a5b6c7d8e9f0
      responses:
        '200':
          description: Push device unregistered successfully.
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                description: 'A registered push notification device token for the Wistia desktop app.

                  Used to deliver activity notifications (new comments and views)

                  for media created via the desktop app.

                  '
                properties:
                  device_token:
                    description: The APNs device token, hex encoded.
                    type: string
                    examples:
                    - 6a41c6f2e5b1d3f4a7c8e9b0d1f2a3c4e5b6d7f8a9c0b1d2e3f4a5b6c7d8e9f0
                  bundle_id:
                    description: The app bundle identifier the token was issued for.
                    type: string
                    examples:
                    - com.wistia.glass
                  environment:
                    description: The APNs environment the token belongs to.
                    type: string
                    enum:
                    - sandbox
                    - production
                  created_at:
                    description: The date the device was first registered.
                    type: string
                    format: date-time
                    examples:
                    - '2026-07-07T18:47:39+00:00'
                  cursor:
                    description: A cursor for stable pagination based on current `sort_by` order. You can pass this to `cursor[before]` or `cursor[after]` as a parameter to fetch the records before or after this record in the same sort order. This is only populated if records were fetched with `cursor[enabled]`, or `cursor[before]` or `cursor[after]`.
                    type:
                    - string
                    - 'null'
                required:
                - device_token
                - bundle_id
                - environment
                - created_at
        '401':
          description: Unauthorized, invalid or missing token
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  code:
                    description: A machine-readable identifier for the specific authorization failure.
                    type: string
                    enum:
                    - unauthorized_credentials
                    - account_inactive
                    - unauthorized_scope
                    - unauthorized_params
                  error:
                    type: string
                    examples:
                    - Invalid credentials.
        '403':
          description: Forbidden, token is valid but account does not have access to feature
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Webinars are not available on your current plan
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Folder with ID 'fakeid' not found.
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Internal server error
      security:
      - BearerAuth: []
      operationId: deleteDevicesByDeviceToken
      x-operation-id-source: derived
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
x-tagGroups:
- name: Data API
  tags:
  - Media
  - Customizations
  - Captions
  - Localizations
  - Trims
  - Extended Audio Descriptions
  - Brands
  - Tags
  - Taggings
  - Folders
  - Folder Sharings
  - Subfolders
  - Channels
  - Channel Collaborators
  - Channel Episodes
  - Webinars
  - Webinar Collaborators
  - Webinar Registrations
  - Account
  - Search
  - Resource URLs
  - Expiring Access Tokens
  - Background Job Status
  - Allowed Domains
  - Remix
  - Push Devices
  - Deleted Media
  - Review Bundles
  - Share Links
  - Bulk Actions
  - Custom Metadata Field Definitions
  - Custom Metadata Field Values
- name: Stats API
  tags:
  - Stats:Account
  - Stats:Events
  - Stats:Media
  - Stats:Projects
  - Stats:Visitors
- name: Analytics API
  tags:
  - Analytics:Account
  - Analytics:Media
  - Analytics:Webinar