Verizon · OpenAPI Overlay 1.0.0

API Evangelist enhancements for Verizon ThingSpace Connectivity Management Accounts Devices API

5 actions 5 updates update extends openapi/verizon-devices-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Verizon's API. It is a proposal applied on top of the contract, not a document Verizon publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-error-catalogx-idempotentx-idempotency-notex-async-resultx-async-correlation-fieldx-apievangelist-providerx-apievangelist-enrichedx-apievangelist-artifacts

Targets 5

$.info

$.components.securitySchemes

$.paths['/accounts/{accountName}/devices/actions/list'].post

$.paths['/accounts/{accountName}/devices/actions/activate'].post

$.paths['/accounts/{accountName}/devices/actions/deactivate'].post

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for Verizon ThingSpace Connectivity Management Accounts Devices API
  version: 1.0.0
extends: openapi/verizon-devices-api-openapi.yml
x-generated: '2026-08-04'
x-method: generated
x-source: conventions/verizon-conventions.yml, errors/verizon-error-codes.yml, authentication/verizon-authentication.yml
actions:
- target: $.info
  description: Record the API Evangelist enrichment context for this API.
  update:
    x-apievangelist-provider: verizon
    x-apievangelist-enriched: '2026-08-04'
    x-apievangelist-artifacts:
      authentication: authentication/verizon-authentication.yml
      conventions: conventions/verizon-conventions.yml
      errors: errors/verizon-error-codes.yml
      lifecycle: lifecycle/verizon-lifecycle.yml
      webhooks: asyncapi/verizon-thingspace-callbacks-webhooks.yml
      data_model: data-model/verizon-data-model.yml
      sandbox: sandbox/verizon-sandbox.yml
      skills: skills/_index.yml
    x-provider-publishes-openapi: false
- target: $.components.securitySchemes
  description: Add the VZ-M2M session token header, which Verizon documents but the harvested spec does
    not declare.
  update:
    VZM2MSessionToken:
      type: apiKey
      in: header
      name: VZ-M2M-Token
      description: Session token from loginSession. Expires after 20 minutes of inactivity. Documented
        at https://thingspace.verizon.com/documentation/apis/connectivity-management/getting-started/getting-credentials.html
- target: $.paths['/accounts/{accountName}/devices/actions/list'].post
  description: Annotate listDevicesInAccount with the runtime semantics captured in conventions/ and errors/.
  update:
    x-error-catalog: errors/verizon-error-codes.yml
    x-idempotent: false
    x-idempotency-note: Verizon documents no idempotency key; a retry re-executes.
    x-async-result: asyncapi/verizon-thingspace-callbacks-webhooks.yml
    x-async-correlation-field: requestId
- target: $.paths['/accounts/{accountName}/devices/actions/activate'].post
  description: Annotate activateDevices with the runtime semantics captured in conventions/ and errors/.
  update:
    x-error-catalog: errors/verizon-error-codes.yml
    x-idempotent: false
    x-idempotency-note: Verizon documents no idempotency key; a retry re-executes.
    x-async-result: asyncapi/verizon-thingspace-callbacks-webhooks.yml
    x-async-correlation-field: requestId
- target: $.paths['/accounts/{accountName}/devices/actions/deactivate'].post
  description: Annotate deactivateDevices with the runtime semantics captured in conventions/ and errors/.
  update:
    x-error-catalog: errors/verizon-error-codes.yml
    x-idempotent: false
    x-idempotency-note: Verizon documents no idempotency key; a retry re-executes.
    x-async-result: asyncapi/verizon-thingspace-callbacks-webhooks.yml
    x-async-correlation-field: requestId