Wistia

Wistia Allowed Domains API

The Allowed Domains API from Wistia — 2 operation(s) for allowed domains.

Documentation GitHub OpenAPI

Operations 8

GET /allowed_domains List Allowed Domains #

POST /allowed_domains Create Allowed Domain #

GET /allowed_domains/{domain} Show Allowed Domain #

DELETE /allowed_domains/{domain} Delete Allowed Domain #

GET /allowed-domains List allowed domains #

POST /allowed-domains Create allowed domain #

GET /allowed-domains/{domain} Show specific allowed domain #

DELETE /allowed-domains/{domain} Delete allowed domain #

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-allowed-domains-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

openapi: 3.2.0
info:
  title: Wistia Allowed Domains API
  version: '1.0'
  description: 'Operations tagged Allowed Domains across 2 of this provider''s published API definitions: wistia-data-api-modern-edge-openapi.yml, wistia-data-api-v1-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.wistia.com/modern
- url: https://api.wistia.com/v1
tags:
- name: Allowed Domains
  x-wistia-mcp-toolsets: sharing
  x-displayName: Allowed Domains
paths:
  /allowed_domains:
    get:
      x-wistia-mcp-ignore: true
      summary: List Allowed Domains
      x-speakeasy-group: allowedDomains
      x-speakeasy-name-override: list
      description: 'Lists allowed domains belonging to the account.


        ## Requires api token with one of the following permissions

        ```

        Read all data

        ```'
      parameters:
      - name: page
        in: query
        description: 'The page number to retrieve. This cannot be combined with `cursor`,

          pagination.

          '
        required: false
        schema:
          type: integer
      - name: per_page
        in: query
        description: The number of medias per page. Use this for both offset pagination and cursor pagination.
        required: false
        schema:
          type: integer
      - name: cursor
        in: query
        description: 'If `cursor[enabled]` is set to 1 then cursor pagination is enabled and the

          first set of records are fetched up to the `per_page`. Cursor

          pagination will also be turned on if `cursor[before]` or `cursor[after]`

          are set. Records returned will have a `cursor` property set which can be used to fetch more records in the same `sort_by` ordering.

          The cursor value of the last record can be used to fetch records after the current result set and

          the cursor of the first record can be used to fetch records before the result set.


          NOTE: a cursor value is only valid if the `sort_by` value hasn''t changed from the

          last fetch. For example, you cannot fetch using `sort_by` id and then pass that

          cursor value to a `sort_by` name.

          '
        required: false
        schema:
          unevaluatedProperties: false
          type: object
          properties:
            enabled:
              description: 'If `cursor[enabled]` is set to 1, the first result set will be fetched with cursor pagination enabled. This

                values is ignored if `cursor[before]` or `cursor[after]` are set.

                '
              type: integer
              enum:
              - 0
              - 1
            before:
              description: 'If `cursor[before]` is set then cursor pagination is enabled and all records

                before the cursor up to the `per_page` are returned. This feature is useful for

                fetching "new records", for example, in a "pull to refersh" feature when showing records in a descending

                order.

                '
              type: string
            after:
              description: 'If `cursor[after]` is set then cursor pagination is enabled and all records

                after the cursor up to the `per_page` are returned.

                '
              type: string
        style: deepObject
      - name: sort_by
        in: query
        description: 'Ordering. When using cursor pagination (see cursor param),

          only `id` and `domain` are supported.

          '
        required: false
        schema:
          type: string
          enum:
          - id
          - domain
          - created
          default: id
      - name: sort_direction
        in: query
        description: Ordering Sort Direction (0 = desc, 1 = asc; default is 1)
        required: false
        schema:
          type: integer
          enum:
          - 0
          - 1
          default: 1
      responses:
        '200':
          description: List of allowed domains
          content:
            application/json:
              schema:
                type: array
                items:
                  unevaluatedProperties: false
                  type: object
                  description: 'An allowed domain represents a domain where a Wistia video can be embedded. Account

                    restrictions need to be enabled for an allowed domain to have an effect. See

                    our [Domain Restrictions](https://support.wistia.com/en/articles/9691672-domain-restrictions)

                    guide for more details.

                    '
                  properties:
                    domain:
                      description: The allowed domain name.
                      type: string
                      examples:
                      - example.com
                    created_at:
                      description: The date that the allowed domain was originally created.
                      type: string
                      format: date-time
                      examples:
                      - '2010-08-13T18: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:
                  - domain
                  - 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.
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Internal server error
      tags:
      - Allowed Domains
      security:
      - BearerAuth: []
      operationId: getAllowedDomains
      x-operation-id-source: derived
    post:
      x-wistia-mcp-ignore: true
      summary: Create Allowed Domain
      x-speakeasy-group: allowedDomains
      x-speakeasy-name-override: create
      description: 'Creates an allowed domain for the account.


        ## Requires api token with one of the following permissions

        ```

        Read, update & delete anything

        ```'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              unevaluatedProperties: false
              type: object
              properties:
                domain:
                  description: The domain name to add (www will be automatically stripped)
                  type: string
                  examples:
                  - example.com
              required:
              - domain
      responses:
        '200':
          description: Allowed domain created successfully (or already exists)
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                description: 'An allowed domain represents a domain where a Wistia video can be embedded. Account

                  restrictions need to be enabled for an allowed domain to have an effect. See

                  our [Domain Restrictions](https://support.wistia.com/en/articles/9691672-domain-restrictions)

                  guide for more details.

                  '
                properties:
                  domain:
                    description: The allowed domain name.
                    type: string
                    examples:
                    - example.com
                  created_at:
                    description: The date that the allowed domain was originally created.
                    type: string
                    format: date-time
                    examples:
                    - '2010-08-13T18: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:
                - domain
                - created_at
        '400':
          description: Bad request - missing or invalid domain
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - The domain's format doesn't look correct. It should be formatted like "mydomain.com"
        '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
      tags:
      - Allowed Domains
      security:
      - BearerAuth: []
      operationId: postAllowedDomains
      x-operation-id-source: derived
    servers:
    - url: https://api.wistia.com/modern
  /allowed_domains/{domain}:
    get:
      x-wistia-mcp-ignore: true
      summary: Show Allowed Domain
      x-speakeasy-group: allowedDomains
      x-speakeasy-name-override: get
      description: 'Returns the details of an allowed domain.


        ## Requires api token with one of the following permissions

        ```

        Read all data

        ```'
      parameters:
      - name: domain
        in: path
        description: The domain name to retrieve
        required: true
        schema:
          type: string
          examples:
          - example.com
      responses:
        '200':
          description: Allowed domain details
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                description: 'An allowed domain represents a domain where a Wistia video can be embedded. Account

                  restrictions need to be enabled for an allowed domain to have an effect. See

                  our [Domain Restrictions](https://support.wistia.com/en/articles/9691672-domain-restrictions)

                  guide for more details.

                  '
                properties:
                  domain:
                    description: The allowed domain name.
                    type: string
                    examples:
                    - example.com
                  created_at:
                    description: The date that the allowed domain was originally created.
                    type: string
                    format: date-time
                    examples:
                    - '2010-08-13T18: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:
                - domain
                - 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.
        '404':
          description: Domain not found
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - domain was not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Internal server error
      tags:
      - Allowed Domains
      security:
      - BearerAuth: []
      operationId: getAllowedDomainsByDomain
      x-operation-id-source: derived
    delete:
      x-wistia-mcp-ignore: true
      summary: Delete Allowed Domain
      x-speakeasy-group: allowedDomains
      x-speakeasy-name-override: delete
      description: 'Deletes an allowed domain from the account.


        ## Requires api token with one of the following permissions

        ```

        Read, update & delete anything

        ```'
      parameters:
      - name: domain
        in: path
        description: The domain name to delete
        required: true
        schema:
          type: string
          examples:
          - example.com
      responses:
        '200':
          description: Allowed domain deleted successfully
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                description: 'An allowed domain represents a domain where a Wistia video can be embedded. Account

                  restrictions need to be enabled for an allowed domain to have an effect. See

                  our [Domain Restrictions](https://support.wistia.com/en/articles/9691672-domain-restrictions)

                  guide for more details.

                  '
                properties:
                  domain:
                    description: The allowed domain name.
                    type: string
                    examples:
                    - example.com
                  created_at:
                    description: The date that the allowed domain was originally created.
                    type: string
                    format: date-time
                    examples:
                    - '2010-08-13T18: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:
                - domain
                - 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: Domain not found
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - domain was not found
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                unevaluatedProperties: false
                type: object
                properties:
                  error:
                    type: string
                    examples:
                    - Internal server error
      tags:
      - Allowed Domains
      security:
      - BearerAuth: []
      operationId: deleteAllowedDomainsByDomain
      x-operation-id-source: derived
    servers:
    - url: https://api.wistia.com/modern
  /allowed-domains:
    get:
      tags:
      - Allowed Domains
      summary: List allowed domains
      operationId: listAllowedDomains
      responses:
        '200':
          description: OK
    post:
      tags:
      - Allowed Domains
      summary: Create allowed domain
      operationId: createAllowedDomain
      responses:
        '201':
          description: Created
  /allowed-domains/{domain}:
    parameters:
    - in: path
      name: domain
      required: true
      schema:
        type: string
    get:
      tags:
      - Allowed Domains
      summary: Show specific allowed domain
      operationId: getAllowedDomain
      responses:
        '200':
          description: OK
    delete:
      tags:
      - Allowed Domains
      summary: Delete allowed domain
      operationId: deleteAllowedDomain
      responses:
        '204':
          description: No Content
components:
  schemas:
    AllowedDomain:
      type: object
      properties:
        domain:
          description: The allowed domain name.
          type: string
          examples:
          - example.com
        created_at:
          description: The date that the allowed domain was originally created.
          type: string
          format: date-time
          examples:
          - '2010-08-13T18:47:39+00:00'
      required:
      - domain
      - created_at
  responses:
    '401':
      description: Unauthorized, invalid or missing token
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                examples:
                - Invalid credentials.
    '500':
      description: Internal server error
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                examples:
                - Internal server error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
    bearerAuth:
      type: http
      scheme: bearer
      description: API access token sent as a Bearer token in the Authorization header
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic authentication using the API token as the password
x-refined-from:
- wistia-data-api-modern-edge-openapi.yml
- wistia-data-api-v1-openapi.yml
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