Esper Enterprise API

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 Enterprise 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: Enterprise
  description: The Esper Enterprise APIs to manage the account information set up for your company’s account. Read our Esper Manage documentation or use the Esper Manage Dashboard through the Esper Developer Console
  externalDocs:
    description: Find out more about enterprise settings
    url: https://docs.esper.io/home/console.html#company-settings
paths:
  /v1/enterprise/{enterprise_id}/:
    parameters:
    - name: enterprise_id
      in: path
      description: A UUID string identifying this enterprise.
      required: true
      schema:
        type: string
        format: uuid
    get:
      operationId: getEnterprise
      summary: Get your enterprise information
      description: Returns Enterprise instance
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnterpriseV1'
      security:
      - apiKey: []
      tags:
      - Enterprise
    patch:
      operationId: partialUpdateEnterprise
      summary: Partial update enterprise information
      description: Returns updated enterprise
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EnterpriseV1'
      security:
      - apiKey: []
      tags:
      - Enterprise
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/EnterpriseUpdateV1'
        required: true
components:
  schemas:
    EnterpriseUpdateV1:
      type: object
      properties:
        id:
          title: Id
          description: Id of the enterprise
          type: string
          format: uuid
          readOnly: true
        name:
          title: Enterprise Name
          description: Name of the enterprise
          type: string
          maxLength: 255
          minLength: 1
        registered_name:
          title: Registered name
          description: Registered Name of the enterprise
          type: string
          maxLength: 255
          minLength: 1
        registered_address:
          title: Registered address
          description: Registered address of the enterprise.
          type: string
          maxLength: 255
          minLength: 1
        location:
          title: Enterprise location
          description: City, State, Country location of the enterprise
          type: string
          maxLength: 255
          minLength: 1
        zipcode:
          title: Enterprise zipcode
          description: Description of the enterprise
          type: string
          maxLength: 8
          minLength: 1
        contact_person:
          title: Contact person
          description: Person who is the point of contact for the enterprise
          type:
          - string
          - 'null'
          maxLength: 255
          minLength: 1
        contact_number:
          title: Contact number
          description: Contact number of the enterprise
          type:
          - string
          - 'null'
          maxLength: 20
          minLength: 1
        contact_email:
          title: Contact email
          description: Contact email address of the enterprise
          type: string
          format: email
          maxLength: 254
          minLength: 1
    EnterpriseV1:
      required:
      - id
      - name
      - short_code
      type: object
      properties:
        id:
          title: Id
          description: Id of the enterprise
          type: string
          format: uuid
          readOnly: true
        name:
          title: Name
          description: Name of the enterprise
          type: string
          maxLength: 255
          minLength: 1
        short_code:
          title: Short code
          description: A short 10-char representation of the enterprise, separated by hyphens. Field is optional, as system will auto-generate a value if none is provided.
          type: string
          maxLength: 10
          minLength: 1
          readOnly: true
        registered_name:
          title: Registered name of the enterprise
          description: Registered Name of the enterprise
          type: string
          maxLength: 255
          minLength: 1
        registered_address:
          title: Registered address
          description: Registered address of the enterprise.
          type: string
          maxLength: 255
          minLength: 1
        location:
          title: Enterprise location
          description: City, State, Country location of the enterprise
          type: string
          maxLength: 255
          minLength: 1
        zipcode:
          title: Enterprise zipcode
          description: Zip code of enterprise location
          type: string
          maxLength: 8
          minLength: 1
        contact_person:
          title: Contact person
          description: Person who is the point of contact for the enterprise
          type:
          - string
          - 'null'
          maxLength: 255
          minLength: 1
        contact_number:
          title: Contact number
          description: Contact number of the enterprise
          type:
          - string
          - 'null'
          maxLength: 20
          minLength: 1
        contact_email:
          title: Contact email
          description: Contact email address of the enterprise
          type: string
          format: email
          maxLength: 254
          minLength: 1
        emm:
          title: Google EMM
          description: This field will have details about emm enrollment if the enterprise is emm enrolled
          type:
          - object
          - 'null'
          properties:
            google_enterprise_id:
              type: string
          maxLength: 50
          minLength: 1
          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