Tessie · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Tessie Vehicle Data API

25 actions 25 updates phrasing extends openapi/tessie-vehicle-data-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Tessie's API. It is a proposal applied on top of the contract, not a document Tessie publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 25 · first 16 shown; the file carries all of them

$.info
$.paths['/{vin}/state'].get
$.paths['/vehicles'].get
$.paths['/{vin}/states'].get
$.paths['/{vin}/battery'].get
$.paths['/battery_health'].get
$.paths['/{vin}/battery_health'].get
$.paths['/{vin}/location'].get
$.paths['/{vin}/firmware_alerts'].get
$.paths['/{vin}/release_notes/{version}'].get
$.paths['/{vin}/map'].get
$.paths['/{vin}/consumption_since_charge'].get
$.paths['/{vin}/weather'].get
$.paths['/{vin}/drives'].get
$.paths['/{vin}/path'].get
$.paths['/{vin}/drives/set_tag'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Tessie Vehicle Data API
  version: 1.0.0
extends: openapi/tessie-vehicle-data-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-11-20'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 24
- target: $.paths['/{vin}/state'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's latest state
      effect: read
      questions:
      - What is the current state of my Tesla, like charge level and location?
      - Can I get a vehicle's latest state from the cache or in real time?
      instructions:
      - text: Get the latest state of vehicle {vin}.
        slots:
          vin: path.vin
      - text: Show the current state of {vin} with use_cache set to {use_cache}.
        slots:
          vin: path.vin
          use_cache: query.use_cache
      method: generated
      generated: '2026-11-20'
- target: $.paths['/vehicles'].get
  update:
    x-apievangelist-phrasing:
      intent: List all vehicles
      effect: read
      questions:
      - Which vehicles are linked to my account?
      - Can I list only active vehicles?
      instructions:
      - text: List all my vehicles.
      - text: List only active vehicles.
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/states'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's historical states
      effect: read
      questions:
      - How has a vehicle's state changed over a time period?
      - Can I get historical states at a set interval?
      instructions:
      - text: Get historical states of {vin} from {from} to {to}.
        slots:
          vin: path.vin
          from: query.from
          to: query.to
      - text: Get {vin}'s states at {interval} second intervals.
        slots:
          vin: path.vin
          interval: query.interval
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/battery'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's battery state
      effect: read
      questions:
      - What is the current battery charge and range of my vehicle?
      - Can I check a car's battery state?
      instructions:
      - text: Get the battery state of {vin}.
        slots:
          vin: path.vin
      - text: Show battery charge and range for {vin}.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/battery_health'].get
  update:
    x-apievangelist-phrasing:
      intent: Get battery health across vehicles
      effect: read
      questions:
      - How healthy are the batteries of all my vehicles?
      - Can I see battery health for a date range?
      instructions:
      - text: Get battery health for all vehicles.
      - text: Show battery health from {from} to {to}.
        slots:
          from: query.from
          to: query.to
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/battery_health'].get
  update:
    x-apievangelist-phrasing:
      intent: Get battery health measurements for a car
      effect: read
      questions:
      - What is a Model 3's battery health over time?
      - Can I get battery health measurements in kilometers?
      instructions:
      - text: Get battery health measurements for {vin}.
        slots:
          vin: path.vin
      - text: Show battery health measurements for {vin} from {from} to {to}.
        slots:
          vin: path.vin
          from: query.from
          to: query.to
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/location'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's location
      effect: read
      questions:
      - Where is my vehicle parked right now?
      - Can I get the street address and saved location of a car?
      instructions:
      - text: Get the location of {vin}.
        slots:
          vin: path.vin
      - text: Show where {vin} is parked.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/firmware_alerts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's firmware alerts
      effect: read
      questions:
      - What firmware alerts has my vehicle generated?
      - Can I see firmware alerts for a time range?
      instructions:
      - text: Get firmware alerts for {vin}.
        slots:
          vin: path.vin
      - text: Show firmware alerts for {vin} from {from} to {to}.
        slots:
          vin: path.vin
          from: query.from
          to: query.to
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/release_notes/{version}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's release notes
      effect: read
      questions:
      - What's new in my vehicle's current software version?
      - Can I read release notes for a staged version?
      instructions:
      - text: Get release notes for {vin}.
        slots:
          vin: path.vin
      - text: Show release notes for {vin} version {version}.
        slots:
          vin: path.vin
          version: path.version
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/map'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's location map
      effect: read
      questions:
      - Can I get a map image of where my vehicle is?
      - Is it possible to change the map's zoom and marker size?
      instructions:
      - text: Get a map of {vin}'s location.
        slots:
          vin: path.vin
      - text: Show {vin} on a {width} by {height} map at zoom {zoom}.
        slots:
          vin: path.vin
          width: query.width
          height: query.height
          zoom: query.zoom
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/consumption_since_charge'].get
  update:
    x-apievangelist-phrasing:
      intent: Get energy consumption since last charge
      effect: read
      questions:
      - How much energy has my vehicle used since the last charge?
      - Can I see consumption data since the last charge?
      instructions:
      - text: Get energy consumption since last charge for {vin}.
        slots:
          vin: path.vin
      - text: Show how much {vin} has used since its last charge.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/weather'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the weather around a vehicle
      effect: read
      questions:
      - What is the weather forecast near my parked vehicle?
      - Can I get a weather forecast for a car's location?
      instructions:
      - text: Get the weather forecast around {vin}.
        slots:
          vin: path.vin
      - text: Show weather near {vin}.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/drives'].get
  update:
    x-apievangelist-phrasing:
      intent: List a vehicle's drives
      effect: read
      questions:
      - What drives has my vehicle recorded?
      - Can I filter drives by tag or distance?
      instructions:
      - text: List the drives for {vin}.
        slots:
          vin: path.vin
      - text: Show {vin}'s drives tagged {tag}.
        slots:
          vin: path.vin
          tag: query.tag
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/path'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a vehicle's driving path
      effect: read
      questions:
      - Can I see the path a vehicle drove over a time period?
      - Is it possible to simplify or separate a vehicle's path by drive?
      instructions:
      - text: Get the driving path of {vin} from {from} to {to}.
        slots:
          vin: path.vin
          from: query.from
          to: query.to
      - text: Show {vin}'s path simplified with separate drives set to {separate}.
        slots:
          vin: path.vin
          separate: query.separate
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/drives/set_tag'].post
  update:
    x-apievangelist-phrasing:
      intent: Tag a vehicle's drives
      effect: write
      questions:
      - Can I tag several drives of a vehicle at once?
      - How do I apply a tag to a list of drive IDs?
      instructions:
      - text: Set tag {tag} on drives {drives} of {vin}.
        slots:
          tag: requestBody.tag
          drives: requestBody.drives
          vin: path.vin
      - text: Apply {tag} to drive IDs {drives} on {vin}.
        slots:
          tag: requestBody.tag
          drives: requestBody.drives
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/charges'].get
  update:
    x-apievangelist-phrasing:
      intent: List a vehicle's charging sessions
      effect: read
      questions:
      - What charges has my vehicle recorded?
      - Can I see only Supercharger charges?
      instructions:
      - text: List the charges for {vin}.
        slots:
          vin: path.vin
      - text: Show Supercharger charges for {vin}.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/charging_invoices'].get
  update:
    x-apievangelist-phrasing:
      intent: Get charging invoices for all vehicles
      effect: read
      questions:
      - Can I get charging invoices for every vehicle in my fleet?
      - Is it possible to filter fleet charging invoices by date?
      instructions:
      - text: Get charging invoices for all vehicles.
      - text: Show fleet charging invoices from {from} to {to}.
        slots:
          from: query.from
          to: query.to
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/charges/{id}/set_cost'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the cost of a charge
      effect: write
      questions:
      - Can I record the cost of a charging session?
      - How do I remove the cost from a charge?
      instructions:
      - text: Set the cost of charge {id} on {vin} to {cost}.
        slots:
          id: path.id
          vin: path.vin
          cost: query.cost
      - text: Record {cost} for charge {id} of {vin}.
        slots:
          cost: query.cost
          id: path.id
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/idles'].get
  update:
    x-apievangelist-phrasing:
      intent: List a vehicle's idles
      effect: read
      questions:
      - When has my vehicle been parked and not driving or charging?
      - Can I see idles within a radius of a location?
      instructions:
      - text: List the idles for {vin}.
        slots:
          vin: path.vin
      - text: Show idles of {vin} within {origin_radius} meters of {origin_latitude}, {origin_longitude}.
        slots:
          vin: path.vin
          origin_radius: query.origin_radius
          origin_latitude: query.origin_latitude
          origin_longitude: query.origin_longitude
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/last_idle_state'].get
  update:
    x-apievangelist-phrasing:
      intent: Get when a vehicle last stopped driving or charging
      effect: read
      questions:
      - When did my vehicle last stop driving or charging?
      - What data is available for a vehicle's last idle state?
      instructions:
      - text: Get the last idle state of {vin}.
        slots:
          vin: path.vin
      - text: Show when {vin} last stopped driving or charging.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/tire_pressure'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a car's tire pressure
      effect: read
      questions:
      - What are the tire pressures on my Tesla right now?
      - Can I get tire pressure in psi instead of bar?
      instructions:
      - text: Get the tire pressure for {vin}.
        slots:
          vin: path.vin
      - text: Show tire pressure for {vin} between {from} and {to}.
        slots:
          vin: path.vin
          from: query.from
          to: query.to
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a car's wake status
      effect: read
      questions:
      - Is my car awake or asleep right now?
      - How do I tell if the car is waiting to go to sleep?
      instructions:
      - text: Get the status of {vin}.
        slots:
          vin: path.vin
      - text: Tell me whether {vin} is asleep, waiting for sleep or awake.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/plate'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a car's license plate
      effect: read
      questions:
      - What license plate is on my Tesla?
      - Can I read the registered plate from the car?
      instructions:
      - text: Get the license plate for {vin}.
        slots:
          vin: path.vin
      - text: Show the registered plate on {vin}.
        slots:
          vin: path.vin
      method: generated
      generated: '2026-11-20'
- target: $.paths['/{vin}/plate'].post
  update:
    x-apievangelist-phrasing:
      intent: Set a car's license plate
      effect: write
      questions:
      - How do I change the license plate registered on my car?
      - Can I set a new plate for the vehicle?
      instructions:
      - text: Set the license plate of {vin} to {plate}.
        slots:
          vin: path.vin
          plate: requestBody.plate
      - text: Register plate {plate} on {vin}.
        slots:
          vin: path.vin
          plate: requestBody.plate
      method: generated
      generated: '2026-11-20'

Work with this as data

Every overlay 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 openapi overlays

4 MCP tools reach this
  • find_overlaysBrowse and filter every overlay in the catalog.
  • 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 overlay
curl "https://apis.io/api/v1/overlays/tessie-vehicle-data-api-phrasing-overlay"
All openapi overlays
curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.