Esper

Esper Token API

Fetch API token information

Documentation GitHub OpenAPI

Operations 2

POST /v0/enterprise/{enterprise_id}/developerapp/{developerapp_id}/renew-token/ Renew Token #

GET /v1/token-info/ Token Information #

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/esper-token-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:
  description: '# Introduction

    Esper APIs are a set of REST-based APIs that help you programmatically control and monitor Android-based Dedicated Devices running the Esper agent using Esper Manage.'
  version: 1.0.0
  title: ESPER API REFERENCE Token API
  termsOfService: https://esper.io/terms-of-service
  contact:
    email: developer@esper.io
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://foo-api.esper.cloud/api
tags:
- name: Token
  description: Fetch API token information
  externalDocs:
    description: Find out more about API get generation
    url: https://docs.esper.io/home/module/genapikey.html
paths:
  /v0/enterprise/{enterprise_id}/developerapp/{developerapp_id}/renew-token/:
    post:
      operationId: renewToken
      summary: Renew Token
      description: API to renew your token
      parameters:
      - name: enterprise_id
        in: path
        description: A UUID string identifying this enterprise.
        required: true
        schema:
          type: string
          format: uuid
      - name: developerapp_id
        in: path
        description: A UUID string identifying the developerapp
        required: true
        schema:
          type: string
          format: uuid
      - name: access_token
        in: query
        description: Token to be renewed
        required: true
        schema:
          type: string
      responses:
        '201':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenRenewV0'
      security:
      - apiKey: []
      tags:
      - Token
  /v1/token-info/:
    get:
      operationId: getTokenInfo
      summary: Token Information
      description: API to get resource information associated with your token like your enterprise, user etc
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TokenInfoV1'
      security:
      - apiKey: []
      tags:
      - Token
components:
  schemas:
    TokenInfoV1:
      required:
      - id
      - enterprise
      type: object
      properties:
        id:
          title: Id
          description: Token id
          type: string
          format: integer
          readOnly: true
        enterprise:
          title: Enterprise id
          description: Id of the enterprise resource
          type: string
          format: uuid
          readOnly: true
        user:
          title: User id
          description: Id of the user resource
          type: string
          readOnly: true
        developer_app:
          title: Developer app id
          description: Id of the developer app resource that you created using the esper dev console
          type: string
          format: uuid
          readOnly: true
        source_refresh_token:
          title: Refresh token
          description: The refresh token is used to refresh your expired API token
          type: string
          readOnly: true
        token:
          title: API Token
          description: API token for accessing esper APIs
          type: string
          readOnly: true
        expires_on:
          title: API token expiry
          description: Date and time of when your API token will get expired
          type: string
          format: date-time
          readOnly: true
        scope:
          title: Scope of API token
          description: This defines what access scopes does your API token has
          type: array
          items:
            type: string
          readOnly: true
        created_on:
          title: Created on
          description: Date and time of when this resource was created
          type: string
          format: date-time
          readOnly: true
        updated_on:
          title: Updated on
          description: Date and time of when this resource was updated
          type: string
          format: date-time
          readOnly: true
    TokenRenewV0:
      type: object
      properties:
        id:
          title: Token id
          description: Id of the token
          type: string
          format: integer
          readOnly: true
        user:
          title: User id
          description: Id of the user resource
          type: string
          readOnly: true
        enterprise:
          title: Enterprise id
          description: Id of the enterprise resource
          type: string
          format: uuid
          readOnly: true
        token:
          title: API Token
          description: API token for accessing esper APIs
          type: string
          readOnly: true
        expires_at:
          title: API token expiry
          description: Date and time of when your API token will get expired
          type: string
          format: date-time
          readOnly: true
        developerapp:
          title: Developer app id
          description: Id of the developer app resource that you created using the esper dev console
          type: string
          format: uuid
          readOnly: true
        scope:
          title: Scope of API token
          description: This defines what access scopes your API token has
          type: string
          readOnly: true
        created_on:
          title: Created on
          description: Date and time of when this resource was created
          type: string
          format: date-time
          readOnly: true
        updated_on:
          title: Updated on
          description: Date and time of when this resource was updated
          type: string
          format: date-time
          readOnly: true
  securitySchemes:
    apiKey:
      description: "#### API KEY - Access Token\nAccess token for APIs passed as authorization header in calls. You need to generate this from your Esper Dev Console at `<domain>-api.esper.cloud` where foo is the sub-domain name you gave for your Esper Dev environment when you signed up for your Esper Dev account. Please follow the instructions [here](https://docs.esper.io/home/module/genapikey.html) to generate an access token.\nOnce you have the access token, you need to send an authorization header as below\n\n```bash\n\n    curl -X GET \\\n      https://<domain>-api.esper.cloud/api/enterprise/<enterprise_id>/device/ \\\n      -H 'Authorization: Bearer <ACCESS_TOKEN>' \\\n      -H 'Content-Type: application/json' \\\n```\n\n> Please note the use of keyword **Bearer** before the token value.\n\n\nYou can read more about api key authentication scheme [here](https://console-docs.esper.io/API/generate.html).\n"
      name: Authorization
      type: apiKey
      in: header
x-tagGroups:
- name: API Reference
  tags:
  - Enterprise
  - Application
  - Application V1
  - Device
  - Device Group
  - Commands
  - Group Commands
  - Token
  - Commands V2
  - Enterprise Policy
  - Geofence
  - Reports
  - Subscription
  - Content