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.
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
# 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.
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.