Tessie

Tessie Driver Management API

Driver management endpoints

GitHub OpenAPI

Operations 9

GET /{vin}/drivers Get Drivers #
POST /{vin}/drivers/{id}/delete Delete Driver #
POST /{vin}/command/enable_guest Enable Guest Mode #
POST /{vin}/command/disable_guest Disable Guest Mode #
GET /{vin}/roles Get Roles #
POST /{vin}/roles Set Roles #
GET /{vin}/invitations Get Invitations #
POST /{vin}/invitations Create an Invitation #
POST /{vin}/invitations/{id}/revoke Revoke an Invitation #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/tessie/openapi/tessie-driver-management-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/tessie/json-schema/tessie-current-state-schema.json
📊
JSONSchema
https://artifacts.apis.io/tessie/json-schema/tessie-condensed-history-states-schema.json
📊
JSONSchema
https://artifacts.apis.io/tessie/json-schema/tessie-history-state-schema.json
📊
JSONSchema
https://artifacts.apis.io/tessie/json-schema/tessie-drive-schema.json
📊
JSONSchema
https://artifacts.apis.io/tessie/json-schema/tessie-release-notes-schema.json
📊
JSONSchema
https://artifacts.apis.io/tessie/json-schema/tessie-charge-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/tessie/apis.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/tessie:tessie-driver-management-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

tessie-driver-management-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Tessie Driver Management API
  version: 1.0.0
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  description: The Tesla management platform.
  contact:
    name: Tessie
    url: https://tessie.com
    email: support@tessie.com
  x-logo:
    url: ''
  termsOfService: https://tessie.com/terms
servers:
- url: https://api.tessie.com
security:
- bearerAuth: []
tags:
- name: Driver Management
  description: Driver management endpoints
paths:
  /{vin}/drivers:
    parameters:
    - $ref: '#/components/parameters/vin'
    get:
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        my_tesla_unique_id:
                          type: integer
                        user_id:
                          type: integer
                        user_id_s:
                          type: string
                        driver_first_name:
                          type: string
                        driver_last_name:
                          type: string
                        granular_access:
                          type: object
                          properties:
                            hide_private:
                              type: boolean
                        active_pubkeys:
                          type: array
                          items:
                            type: string
                        public_key:
                          type: string
                x-examples:
                  Example 1:
                    results:
                    - my_tesla_unique_id: 123456789
                      user_id: 222222
                      user_id_s: '222222'
                      driver_first_name: Jane
                      driver_last_name: Doe
                      granular_access:
                        hide_private: false
                      active_pubkeys:
                      - 043da2708632f7d7c01f6cacdd82400746asdfd475c37a6adfaa19aed565f3e254790c1baaac94ee2c68349642d21e16bf89c70a13019516ed475104c945cb3d53
                      public_key: ''
                    - my_tesla_unique_id: 12345678
                      user_id: 111111
                      user_id_s: '222222'
                      driver_first_name: John
                      driver_last_name: Doe
                      granular_access:
                        hide_private: false
                      active_pubkeys:
                      - 04b7f61ba31002e4646f647953e2a2813e72e7315asdfe2bfa0badad9d42c0e3762e581c5ae58010146ccd9288333ceff26b84e57ae624fc4f7428ee20e719f00d
                      public_key: 04b7f61ba31002e4646f647953e2a2813e72e7315asdfe2bfa0badad9d42c0e3762e581c5ae58010146ccd9288333ceff26b84e57ae624fc4f7428ee20e719f00d
              examples:
                Example 1:
                  value:
                    results:
                    - my_tesla_unique_id: 88888888
                      user_id: 1234567
                      user_id_s: '1234567'
                      driver_first_name: Jane
                      driver_last_name: Doe
                      granular_access:
                        hide_private: false
                      active_pubkeys:
                      - 043da2708632f7d7c01f6casdf824007465408d475c37a6adfaa19aed565f3e254790c1baaac94ee2c68349642d21e16bf89c70a13019516ed475104c945cb3d53
                      public_key: ''
                    - my_tesla_unique_id: 99999999
                      user_id: 123456
                      user_id_s: '123456'
                      driver_first_name: John
                      driver_last_name: Doe
                      granular_access:
                        hide_private: false
                      active_pubkeys:
                      - 04b7f61ba31002e4646f64795asdf2813e72e73159947e2bfa0badad9d42c0e3762e581c5ae58010146ccd9288333ceff26b84e57ae624fc4f7428ee20e719f00d
                      public_key: 04b7f61ba31002e4646f64795asdf2813e72e73159947e2bfa0badad9d42c0e3762e581c5ae58010146ccd9288333ceff26b84e57ae624fc4f7428ee20e719f00d
      operationId: get-drivers
      summary: Get Drivers
      description: Returns a list of additional drivers.
      x-stoplight:
        id: asydyeacarbox
      tags:
      - Driver Management
  /{vin}/drivers/{id}/delete:
    parameters:
    - $ref: '#/components/parameters/vin'
    - schema:
        type: string
      name: id
      in: path
      required: true
      description: Driver ID.
    post:
      summary: Delete Driver
      operationId: delete-driver
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: boolean
                x-examples:
                  Example 1:
                    result: true
              examples:
                Example 1:
                  value:
                    result: true
      x-stoplight:
        id: axr4difxrhjlc
      description: Deletes a driver from the vehicle.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-examples:
                Example 1:
                  user_id: 12345678
              properties:
                user_id:
                  type: integer
        description: ''
      tags:
      - Driver Management
  /{vin}/command/enable_guest:
    parameters:
    - $ref: '#/components/parameters/vin'
    post:
      parameters:
      - $ref: '#/components/parameters/wait_for_completion'
      - $ref: '#/components/parameters/max_attempts'
      responses:
        '200':
          $ref: '#/components/responses/commandResponse'
      operationId: enable-guest
      summary: Enable Guest Mode
      description: Enables Guest Mode.
      x-stoplight:
        id: o4dtqwqk4hypr
      tags:
      - Driver Management
  /{vin}/command/disable_guest:
    parameters:
    - $ref: '#/components/parameters/vin'
    post:
      parameters:
      - $ref: '#/components/parameters/wait_for_completion'
      - $ref: '#/components/parameters/max_attempts'
      responses:
        '200':
          $ref: '#/components/responses/commandResponse'
      operationId: disable-guest
      summary: Disable Guest Mode
      description: Disables Guest Mode.
      x-stoplight:
        id: byyvvv73siawo
      tags:
      - Driver Management
  /{vin}/roles:
    parameters:
    - $ref: '#/components/parameters/vin'
    get:
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    result:
                      owner:
                        entity_type: PERSON
                        account_id: '123456789'
                        federation_id: abcdef12-3456-7890-abcd-ef1234567890
                        company_name: null
                        email: owner@example.com
                      drivers:
                      - entity_type: PERSON
                        account_id: '987654321'
                        federation_id: fedcba98-7654-3210-fedc-ba9876543210
                        company_name: null
                        email: driver@example.com
                      payers:
                        subscription:
                          entity_type: BUSINESS
                          account_id: '555555555'
                          federation_id: 11111111-2222-3333-4444-555555555555
                          company_name: Example Fleet
                          email: billing@example.com
                        charging:
                          entity_type: PERSON
                          account_id: '123456789'
                          federation_id: abcdef12-3456-7890-abcd-ef1234567890
                          company_name: null
                          email: owner@example.com
                properties:
                  result:
                    type: object
                    properties:
                      owner:
                        type: object
                        properties:
                          entity_type:
                            type:
                            - string
                            - 'null'
                            enum:
                            - PERSON
                            - BUSINESS
                          account_id:
                            type:
                            - string
                            - 'null'
                          federation_id:
                            type:
                            - string
                            - 'null'
                          company_name:
                            type:
                            - string
                            - 'null'
                          email:
                            type:
                            - string
                            - 'null'
                      drivers:
                        type: array
                        items:
                          type: object
                          properties:
                            entity_type:
                              type:
                              - string
                              - 'null'
                              enum:
                              - PERSON
                              - BUSINESS
                            account_id:
                              type:
                              - string
                              - 'null'
                            federation_id:
                              type:
                              - string
                              - 'null'
                            company_name:
                              type:
                              - string
                              - 'null'
                            email:
                              type:
                              - string
                              - 'null'
                      payers:
                        type: object
                        properties:
                          subscription:
                            type:
                            - object
                            - 'null'
                            properties:
                              entity_type:
                                type:
                                - string
                                - 'null'
                                enum:
                                - PERSON
                                - BUSINESS
                              account_id:
                                type:
                                - string
                                - 'null'
                              federation_id:
                                type:
                                - string
                                - 'null'
                              company_name:
                                type:
                                - string
                                - 'null'
                              email:
                                type:
                                - string
                                - 'null'
                          charging:
                            type:
                            - object
                            - 'null'
                            properties:
                              entity_type:
                                type:
                                - string
                                - 'null'
                                enum:
                                - PERSON
                                - BUSINESS
                              account_id:
                                type:
                                - string
                                - 'null'
                              federation_id:
                                type:
                                - string
                                - 'null'
                              company_name:
                                type:
                                - string
                                - 'null'
                              email:
                                type:
                                - string
                                - 'null'
              examples:
                Example 1:
                  value:
                    result:
                      owner:
                        entity_type: PERSON
                        account_id: '123456789'
                        federation_id: abcdef12-3456-7890-abcd-ef1234567890
                        company_name: null
                        email: owner@example.com
                      drivers:
                      - entity_type: PERSON
                        account_id: '987654321'
                        federation_id: fedcba98-7654-3210-fedc-ba9876543210
                        company_name: null
                        email: driver@example.com
                      payers:
                        subscription:
                          entity_type: BUSINESS
                          account_id: '555555555'
                          federation_id: 11111111-2222-3333-4444-555555555555
                          company_name: Example Fleet
                          email: billing@example.com
                        charging:
                          entity_type: PERSON
                          account_id: '123456789'
                          federation_id: abcdef12-3456-7890-abcd-ef1234567890
                          company_name: null
                          email: owner@example.com
      operationId: get-roles
      summary: Get Roles
      description: Returns the owner, drivers and assigned payer roles for a vehicle. Requires a Tesla Business account.
      tags:
      - Driver Management
    post:
      summary: Set Roles
      operationId: set-roles
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: boolean
                x-examples:
                  Example 1:
                    result: true
              examples:
                Example 1:
                  value:
                    result: true
      description: Sets the subscription or charging payer role for a vehicle. Requires a Tesla Business account.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - role
              x-examples:
                Example 1:
                  role: SUBSCRIPTION
                  account_id: '555555555'
              properties:
                role:
                  type: string
                  enum:
                  - SUBSCRIPTION
                  - CHARGING
                  description: The payer role to assign.
                account_id:
                  type: string
                  description: The Tesla account ID to assign the payer role to.
                federation_id:
                  type: string
                  description: The Tesla federation ID to assign the payer role to.
            examples:
              Example 1:
                value:
                  role: SUBSCRIPTION
                  account_id: '555555555'
              Example 2:
                value:
                  role: CHARGING
                  federation_id: 11111111-2222-3333-4444-555555555555
      tags:
      - Driver Management
  /{vin}/invitations:
    parameters:
    - $ref: '#/components/parameters/vin'
    get:
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    results:
                    - id: 2252266471835111
                      owner_id: 1234567
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: asdZ0FG_yuioQ7OoVx1_e5-asdft83MqxT7BY8DsaeCs
                      expires_at: '2023-11-29T00:55:31.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: '2252266471835111'
                      owner_id_s: '1234567'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/asdZ0FG_yuioQ7OoVx1_e5-asdft83MqxT7BY8DsaeCs
                    - id: 2252270843114112
                      owner_id: 1234567
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: asd7Qqpxlq6-kKZ2Aasdfw3oCp_yuioYJnQsYYB2jL3w
                      expires_at: '2023-11-29T00:55:18.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: '2252270843114112'
                      owner_id_s: '1234567'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/asd7Qqpxlq6-kKZ2Aasdfw3oCp_yuioYJnQsYYB2jL3w
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                        owner_id:
                          type: integer
                        product_id:
                          type: string
                        share_user_id:
                          type:
                          - integer
                          - 'null'
                        state:
                          type: string
                        code:
                          type: string
                        expires_at:
                          type: string
                        revoked_at:
                          type:
                          - string
                          - 'null'
                        borrowing_device_id:
                          type:
                          - integer
                          - 'null'
                        key_id:
                          type:
                          - string
                          - 'null'
                        product_type:
                          type: string
                        share_type:
                          type: string
                        active_pubkeys:
                          type: array
                          items:
                            type:
                            - string
                            - 'null'
                        id_s:
                          type: string
                        owner_id_s:
                          type: string
                        share_user_id_s:
                          type: string
                        borrowing_key_hash:
                          type:
                          - string
                          - 'null'
                        vin:
                          type: string
                        share_link:
                          type: string
              examples:
                Example 1:
                  value:
                    results:
                    - id: 2252266471835261
                      owner_id: 1311857
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: d9SZ0FG_CuVqQ7OoVx1_e5-UOGLt83MqxT7BY8DsaeCs
                      expires_at: '2023-11-29T00:55:31.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: '2252266471835261'
                      owner_id_s: '1311857'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/d9SZ0FG_CuVqQ7OoVx1_e5-UOGLt83MqxT7BY8DsaeCs
                    - id: 2252267587512399
                      owner_id: 1311857
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: deu-VGwpumXGXSLHCpWN2DVedKIs7fBpdiqO76Qv7KW4
                      expires_at: '2023-11-29T00:59:06.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: '2252267587512399'
                      owner_id_s: '1311857'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/deu-VGwpumXGXSLHCpWN2DVedKIs7fBpdiqO76Qv7KW4
                    - id: 2252270843114074
                      owner_id: 1311857
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: div7Qqpxlq6-kKZ2AxkvLw3oCp_JsxdYJnQsYYB2jL3w
                      expires_at: '2023-11-29T00:55:18.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: 7SAXCBE6XPF123456
                      owner_id_s: '1311857'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/div7Qqpxlq6-kKZ2AxkvLw3oCp_JsxdYJnQsYYB2jL3w
      operationId: get-invitations
      summary: Get Invitations
      description: Returns a list of driver invitations.
      x-stoplight:
        id: 3deknc00ndbkt
      tags:
      - Driver Management
    post:
      summary: Create an Invitation
      operationId: create-invitation
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                x-examples:
                  Example 1:
                    result:
                      id: 2252267587512112
                      owner_id: 1234567
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: asdfGwpumXGXSLHCpWN2DVedKIs7fBpdiqO76Qvyuio
                      expires_at: '2023-11-29T00:59:06.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: '2252267587512112'
                      owner_id_s: '1234567'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/asdfGwpumXGXSLHCpWN2DVedKIs7fBpdiqO76Qvyuio
                properties:
                  result:
                    type: object
                    properties:
                      id:
                        type: integer
                      owner_id:
                        type: integer
                      share_user_id:
                        type:
                        - integer
                        - 'null'
                      product_id:
                        type: string
                      state:
                        type: string
                      code:
                        type: string
                      expires_at:
                        type: string
                      revoked_at:
                        type:
                        - string
                        - 'null'
                      borrowing_device_id:
                        type:
                        - integer
                        - 'null'
                      key_id:
                        type:
                        - integer
                        - 'null'
                      product_type:
                        type: string
                      share_type:
                        type: string
                      active_pubkeys:
                        type: array
                        items:
                          type:
                          - string
                          - 'null'
                      id_s:
                        type: string
                      owner_id_s:
                        type: string
                      share_user_id_s:
                        type: string
                      borrowing_key_hash:
                        type:
                        - string
                        - 'null'
                      vin:
                        type: string
                      share_link:
                        type: string
              examples:
                Example 1:
                  value:
                    result:
                      id: 2252275396890299
                      owner_id: 1311857
                      share_user_id: null
                      product_id: 7SAXCBE6XPF123456
                      state: pending
                      code: dgIPJtGS_CnIprYz0yy1dDvduRl0mQBYEwA-u_Fsc_5w
                      expires_at: '2023-11-29T01:53:09.000Z'
                      revoked_at: null
                      borrowing_device_id: null
                      key_id: null
                      product_type: vehicle
                      share_type: customer
                      active_pubkeys:
                      - null
                      id_s: '2252275396890299'
                      owner_id_s: '1311857'
                      share_user_id_s: ''
                      borrowing_key_hash: null
                      vin: 7SAXCBE6XPF123456
                      share_link: https://www.tesla.com/_rs/1/dgIPJtGS_CnIprYz0yy1dDvduRl0mQBYEwA-u_Fsc_5w
      x-stoplight:
        id: re1enz71rh7pf
      description: Creates a driver invitation.
      tags:
      - Driver Management
  /{vin}/invitations/{id}/revoke:
    parameters:
    - $ref: '#/components/parameters/vin'
    - schema:
        type: string
      name: id
      in: path
      required: true
      description: Invitation ID.
    post:
      summary: Revoke an Invitation
      operationId: revoke-invitation
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    type: boolean
                x-examples:
                  Example 1:
                    result: true
              examples:
                Example 1:
                  value:
                    result: true
      description: Revokes a driver invitation.
      x-stoplight:
        id: rio253hcpzdst
      tags:
      - Driver Management
components:
  responses:
    commandResponse:
      content:
        application/json:
          schema:
            type: object
            properties:
              result:
                description: Whether the command was successful.
                type: boolean
          examples:
            Example 1:
              value:
                result: true
      description: Success
  parameters:
    max_attempts:
      name: max_attempts
      description: The maximum number of attempts to make to execute the command.
      schema:
        default: 3
        maximum: 3
        minimum: 1
        type: integer
      in: query
      required: false
      allowEmptyValue: false
      deprecated: false
    vin:
      name: vin
      description: The associated VIN.
      schema:
        type: string
      in: path
      required: true
      deprecated: false
      x-last-modified: 1643747623235
      example: 5YJXCAE43LF123456
    wait_for_completion:
      name: wait_for_completion
      description: Whether to wait for the command to complete before returning a response.
      schema:
        default: true
        type: boolean
      in: query
      required: false
      allowEmptyValue: false
      deprecated: false
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http