Get State

home_assistant.get_state
ActionBusiness appsconnection required

Calls the Home Assistant API with the connection's credentials.

Read one entity's current state and attributes.

Connection

Required
Yes — the node will not save without one
Auth type
Bearer token
Providers
Home Assistant
Secret shape
the long-lived access token, or {"access_token": "…"}
Config it needs
base_url
Resolved by
config.connection_id, else node.connection_id

Configuration

1 field, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

FieldTypeRequiredDefaultConstraintsExample
entity_id
The entity to read, as '<domain>.<object_id>'.
stringYes——light.kitchen

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "entity_id": "light.kitchen"
}

Output

One shape.

result

FieldTypeExample
entity_id
The entity this state belongs to.
stringlight.kitchen
state
The state itself, always a string.
stringon
attributes
The entity's attributes, including friendly_name.
object—
last_changed
When the state last changed, ISO-8601.
string—
last_updated
When the state object was last written, ISO-8601.
string—
context
Who or what caused the change (id, user_id, parent_id).
object—
{
  "attributes": {},
  "context": {},
  "entity_id": "light.kitchen",
  "last_changed": "",
  "last_updated": "",
  "state": "on"
}

See Get State run in a workflow.

In a technical demo we add the Home Assistant connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.