Optimizely

Optimizely Device Tokens API

The Device Tokens API from Optimizely — 7 operation(s) for device tokens.

GitHub OpenAPI

Operations 11

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 /api/v1/admin/device-tokens/register Register a device for push notifications · Device tokens V1 register device token #
Ask an LLM
“How do I register a mobile device token so the current user gets push notifications?”
“Can the app sign a device up for notifications with just its token?”
Tell an agent
Register device token {deviceToken} for push notifications.
Sign up device {deviceToken} to receive notifications.
POST /api/v1/admin/device-tokens/unregister Stop push notifications to a device · Device tokens V1 unregister device token #
Ask an LLM
“How can an app stop push notifications to a device when the user logs out?”
“Can I unregister a device token so it no longer gets notified?”
Tell an agent destructive · confirm first
Unregister device token {deviceToken}.
Stop sending push notifications to device {deviceToken}.
GET /api/v1/admin/DeviceTokens List stored device tokens · Returns the EntitySet DeviceTokens #
Ask an LLM
“Which device tokens are stored in the Optimizely Commerce admin?”
“Can I filter device tokens to ones that are disabled?”
Tell an agent
List all stored device tokens.
Show device tokens matching {filter}.
POST /api/v1/admin/DeviceTokens Create a device token record as an admin · Post a new entity to EntitySet DeviceTokens #
Ask an LLM
“Can an admin add a device token record directly for a user profile?”
“What fields does an admin-created device token record need?”
Tell an agent
Create an admin device token record {token} for user profile {userProfileId}.
Add device token entity {token} with disabled set to {disabled}.
GET /api/v1/admin/DeviceTokens({id}) Get one device token record · Returns the entity with the key from DeviceTokens #
Ask an LLM
“Which user does a stored device token belong to?”
“Can I look up a single device token record by id?”
Tell an agent
Fetch device token record {id}.
Show the user profile and status of device token {id}.
PUT /api/v1/admin/DeviceTokens({id}) Replace a device token record · Replace entity in EntitySet DeviceTokens #
Ask an LLM
“Can I overwrite a stored device token record entirely?”
“Does replacing a device token record require resending the token value?”
Tell an agent
Replace device token record {id} with token {token}.
Overwrite the full record of device token {id}.
DELETE /api/v1/admin/DeviceTokens({id}) Delete one device token record · Delete entity in EntitySet DeviceTokens #
Ask an LLM
“How do I delete a single stored device token record?”
“Can deleting a device token record be guarded by an ETag?”
Tell an agent destructive · confirm first
Delete device token record {id}.
Delete device token {id} only if its ETag is {etag}.
PATCH /api/v1/admin/DeviceTokens({id}) Enable or disable a stored device token · Update entity in EntitySet DeviceTokens #
Ask an LLM
“Can I disable a stored device token without deleting it?”
“Is it possible to reassign a device token record to another user profile?”
Tell an agent
Set device token {id} disabled flag to {disabled}.
Move device token {id} to user profile {userProfileId}.
GET /api/v1/admin/DeviceTokens/Default.Default() Get default values for a device token · Call operation Default #
Ask an LLM
“What defaults does a new device token record start with?”
“Is there an empty device token template?”
Tell an agent
Get the default field values for a new device token.
Show the blank device token template.
DELETE /api/v1/admin/devicetokens/delete Bulk delete device token records · Device tokens delete route #
Ask an LLM
“Can I remove many device token records in one request?”
“Is there a batch delete for device tokens by id list?”
Tell an agent destructive · confirm first
Bulk delete device token records {ids}.
Permanently delete every device token in {ids}.
GET /api/v1/admin/devicetokens({key})/customproperties({custompropertyKey}) Get a custom property on a device token · Device tokens get custom property by key and custompropertykey #
Ask an LLM
“How can I read a custom property stored on a device token?”
“Can I fetch one custom field value from a device token record?”
Tell an agent
Get custom property {custompropertyKey} of device token {key}.
Show the {custompropertyKey} custom property on device token {key}.

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/optimizely/refs/heads/main/openapi/optimizely-device-tokens-api-openapi.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/optimizely:optimizely-device-tokens-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

optimizely-device-tokens-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: admin-v1
  title: Admin API V1 Device Tokens API
servers:
- url: https://dogfood.commerce.insitesandbox.com
security: []
tags:
- name: Device Tokens
paths:
  /api/v1/admin/device-tokens/register:
    post:
      tags:
      - Device Tokens
      operationId: DeviceTokensV1_RegisterDeviceToken
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.RegisterDeviceTokenDto'
          text/json:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.RegisterDeviceTokenDto'
          application/xml:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.RegisterDeviceTokenDto'
          text/xml:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.RegisterDeviceTokenDto'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.RegisterDeviceTokenDto'
          text/html:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.RegisterDeviceTokenDto'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
            text/json:
              schema:
                type: object
            application/xml:
              schema:
                type: object
            text/xml:
              schema:
                type: object
            text/html:
              schema:
                type: object
      summary: Device tokens V1 register device token
      x-summary-source: derived
  /api/v1/admin/device-tokens/unregister:
    post:
      tags:
      - Device Tokens
      operationId: DeviceTokensV1_UnregisterDeviceToken
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto'
          text/json:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto'
          application/xml:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto'
          text/xml:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto'
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto'
          text/html:
            schema:
              $ref: '#/components/schemas/Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
            text/json:
              schema:
                type: object
            application/xml:
              schema:
                type: object
            text/xml:
              schema:
                type: object
            text/html:
              schema:
                type: object
      summary: Device tokens V1 unregister device token
      x-summary-source: derived
  /api/v1/admin/DeviceTokens:
    get:
      tags:
      - Device Tokens
      summary: Returns the EntitySet DeviceTokens
      operationId: DeviceTokens_Get
      parameters:
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $filter
        in: query
        description: Filters the results, based on a Boolean condition.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      - name: $apply
        in: query
        description: Aggregates the results according to one or more transformations.
        required: false
        schema:
          type: string
      - name: $orderby
        in: query
        description: Sorts the results.
        required: false
        schema:
          type: string
      - name: $top
        in: query
        description: Returns only the first n results.
        required: false
        schema:
          type: integer
          format: int32
      - name: $skip
        in: query
        description: Skips the first n results.
        required: false
        schema:
          type: integer
          format: int32
      - name: $count
        in: query
        description: Includes a count of the matching results in the response.
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    post:
      tags:
      - Device Tokens
      summary: Post a new entity to EntitySet DeviceTokens
      operationId: DeviceTokens_Post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.DeviceToken'
        description: The entity to post
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/DeviceTokens({id}):
    get:
      tags:
      - Device Tokens
      summary: Returns the entity with the key from DeviceTokens
      operationId: DeviceTokens_GetById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    put:
      tags:
      - Device Tokens
      summary: Replace entity in EntitySet DeviceTokens
      operationId: DeviceTokens_PutById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.DeviceToken'
        description: The entity to put
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    delete:
      tags:
      - Device Tokens
      summary: Delete entity in EntitySet DeviceTokens
      operationId: DeviceTokens_DeleteById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      - name: If-Match
        in: header
        description: If-Match header
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
    patch:
      tags:
      - Device Tokens
      summary: Update entity in EntitySet DeviceTokens
      operationId: DeviceTokens_PatchById
      parameters:
      - name: id
        in: path
        description: 'key: id'
        required: true
        schema:
          type: string
          format: uuid
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Insite.Data.Entities.DeviceToken'
        description: The entity to patch
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/DeviceTokens/Default.Default():
    get:
      tags:
      - Device Tokens
      summary: Call operation Default
      operationId: DeviceTokens_Default
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
  /api/v1/admin/devicetokens/delete:
    delete:
      tags:
      - Device Tokens
      operationId: DeviceTokens_DeleteRoute
      parameters:
      - name: ids
        in: query
        required: true
        explode: true
        schema:
          type: array
          items:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Device tokens delete route
      x-summary-source: derived
  /api/v1/admin/devicetokens({key})/customproperties({custompropertyKey}):
    get:
      tags:
      - Device Tokens
      operationId: DeviceTokens_GetCustomPropertyByKeyAndCustompropertykey
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: custompropertyKey
        in: path
        required: true
        schema:
          type: string
          format: uuid
      - name: $expand
        in: query
        description: Expands related entities inline.
        required: false
        schema:
          type: string
      - name: $select
        in: query
        description: Selects which properties to include in the response.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
      deprecated: false
      security:
      - access_token: []
      summary: Device tokens get custom property by key and custompropertykey
      x-summary-source: derived
components:
  schemas:
    Insite.Admin.Controllers.Api.UnregisterDeviceTokenDto:
      required:
      - deviceToken
      type: object
      properties:
        deviceToken:
          maxLength: 256
          minLength: 1
          type: string
    Insite.Data.Entities.DeviceToken:
      required:
      - token
      type: object
      properties:
        id:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        userProfileId:
          format: uuid
          type: string
          example: 00000000-0000-0000-0000-000000000000
        token:
          maxLength: 256
          minLength: 0
          type: string
        disabled:
          type: boolean
        createdOn:
          format: date-time
          type: string
        createdBy:
          type: string
        modifiedOn:
          format: date-time
          type: string
        modifiedBy:
          type: string
    Insite.Admin.Controllers.Api.RegisterDeviceTokenDto:
      required:
      - deviceToken
      type: object
      properties:
        deviceToken:
          maxLength: 256
          minLength: 1
          type: string
  securitySchemes:
    access_token:
      type: apiKey
      description: Token used to access storefront API.
      name: access_token
      in: query