Microsoft Azure API Tokens API

The API Tokens API from Microsoft Azure — 2 operation(s) for api tokens.

Documentation GitHub OpenAPI

Business capability

Developer Identity & Credential Management BC-4270.40

Operations 4

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

GET /apiTokens List IoT Central API tokens · Microsoft Azure Get The List Of Api Tokens In An Application The Token Value… #

Ask an LLM

“Which API tokens exist in my IoT Central application?”

“Will listing API tokens show me the token values?”

Tell an agent

List the API tokens in my IoT Central application.

Show all IoT Central API tokens using API version {api_version}.

GET /apiTokens/{tokenId} Get an IoT Central API token · Microsoft Azure Get An Api Token By Id #

Ask an LLM

“What roles and expiry does one API token have?”

“Can I look up an IoT Central API token by its ID?”

Tell an agent

Get API token {tokenId}.

Show the roles and expiry of IoT Central token {tokenId}.

PUT /apiTokens/{tokenId} Create an IoT Central API token · Microsoft Azure Create A New Api Token In The Application To Use In The Iot… #

Ask an LLM

“How do I create a token to call the IoT Central public API?”

“Can I set an expiry date and roles when generating an API token?”

Tell an agent

Create API token {tokenId} with roles {roles}.

Generate IoT Central token {tokenId} with roles {roles} expiring {expiry}.

DELETE /apiTokens/{tokenId} Delete an IoT Central API token · Microsoft Azure Delete An Api Token #

Ask an LLM

“Can I revoke an API token in my IoT Central app?”

“Can I delete a token that's been leaked?”

Tell an agent destructive · confirm first

Delete API token {tokenId}.

Revoke IoT Central token {tokenId}.

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/microsoft-azure:microsoft-azure-api-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

openapi: 3.2.0
info:
  title: Microsoft Azure Azure IoT Central API Tokens API
  description: Azure IoT Central is a service that makes it easy to connect, monitor, and manage your IoT devices at scale.
  version: 2022-10-31-preview
servers:
- url: /api
security:
- azure_auth:
  - user_impersonation
tags:
- name: API Tokens
paths:
  /apiTokens:
    get:
      operationId: microsoftAzureApitokensList
      summary: Microsoft Azure Get The List Of Api Tokens In An Application The Token Value…
      x-ms-examples:
        List API tokens:
          $ref: ./examples/apitoken_list.json
      parameters:
      - $ref: '#/components/parameters/Version'
      x-ms-pageable:
        nextLinkName: nextLink
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiTokenCollection'
        default:
          description: An error response received from the IoT Central Service.
          headers:
            x-ms-error-code:
              description: Error code for specific error that occurred.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: Needs a more full description created.
      tags:
      - API Tokens
  /apiTokens/{tokenId}:
    get:
      operationId: microsoftAzureApitokensGet
      summary: Microsoft Azure Get An Api Token By Id
      x-ms-examples:
        Get API token by ID:
          $ref: ./examples/apitoken_get.json
      parameters:
      - $ref: '#/components/parameters/Version'
      - in: path
        name: tokenId
        description: Unique ID for the API token.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiToken'
        default:
          description: An error response received from the IoT Central Service.
          headers:
            x-ms-error-code:
              description: Error code for specific error that occurred.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: Needs a more full description created.
      tags:
      - API Tokens
    put:
      operationId: microsoftAzureApitokensCreate
      summary: Microsoft Azure Create A New Api Token In The Application To Use In The Iot…
      x-ms-examples:
        Create API token:
          $ref: ./examples/apitoken_create.json
      parameters:
      - $ref: '#/components/parameters/Version'
      - in: path
        name: tokenId
        description: Unique ID for the API token.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiToken'
        default:
          description: An error response received from the IoT Central Service.
          headers:
            x-ms-error-code:
              description: Error code for specific error that occurred.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: Needs a more full description created.
      tags:
      - API Tokens
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApiToken'
        description: API token body.
        required: true
    delete:
      operationId: microsoftAzureApitokensRemove
      summary: Microsoft Azure Delete An Api Token
      x-ms-examples:
        Delete API token:
          $ref: ./examples/apitoken_delete.json
      parameters:
      - $ref: '#/components/parameters/Version'
      - in: path
        name: tokenId
        description: Unique ID for the API token.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Success
        default:
          description: An error response received from the IoT Central Service.
          headers:
            x-ms-error-code:
              description: Error code for specific error that occurred.
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      description: Needs a more full description created.
      tags:
      - API Tokens
components:
  schemas:
    Permission:
      description: The permission definition.
      type: object
      properties:
        roles:
          description: List of role assignments that specify the permissions to access the application.
          type: array
          items:
            $ref: '#/components/schemas/RoleAssignment'
          minItems: 1
      required:
      - roles
    ErrorDetails:
      description: The detail information of the error.
      type: object
      properties:
        code:
          type: string
          description: Error code.
        message:
          type: string
          description: Error message details.
        requestId:
          type: string
          description: Correlation Id for current request.
        time:
          type: string
          format: date-time-rfc1123
          description: The time that error request failed.
      required:
      - code
      - message
    Error:
      description: The response error definition.
      type: object
      properties:
        error:
          description: Error details for current request.
          $ref: '#/components/schemas/ErrorDetails'
      required:
      - error
    RoleAssignment:
      description: The role assignment definition.
      type: object
      properties:
        role:
          description: ID of the role for this role assignment.
          type: string
        organization:
          description: ID of the organization for this role assignment.
          type: string
      required:
      - role
    ApiTokenCollection:
      description: The paged results of API tokens.
      type: object
      properties:
        value:
          description: The collection of API tokens.
          type: array
          items:
            $ref: '#/components/schemas/ApiToken'
        nextLink:
          description: URL to get the next page of API tokens.
          type: string
      required:
      - value
    ApiToken:
      description: The access token definition.
      allOf:
      - $ref: '#/components/schemas/Permission'
      type: object
      properties:
        id:
          description: Unique ID of the API token.
          type: string
          readOnly: true
        token:
          description: Value of the API token.
          type: string
          readOnly: true
        expiry:
          description: String-formatted date representing the time when the token expires.
          type: string
          format: date-time
  parameters:
    Version:
      in: query
      name: api-version
      description: The version of the API being called.
      x-ms-parameter-location: client
      required: true
      schema:
        type: string
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow
x-ms-parameterized-host:
  hostTemplate: '{subdomain}.{baseDomain}'
  parameters:
  - $ref: '#/components/parameters/BaseDomain'
  - $ref: '#/components/parameters/Subdomain'

Microsoft Azure API Tokens API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification