The Adafruit IO connector lets your AI agent act in each user's Adafruit IO account. Each user connects their own Adafruit IO API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.
- Tools
- 59
- What they doRead · write · destructive
- 25 · 25 · 925 read25 write9 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Adafruit IO connection
In AgentKit > Connections, create an Adafruit IO connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'adafruitio'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Adafruit IO:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'adafruitio_user_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "adafruitio"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Adafruit IO:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="adafruitio_user_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Adafruit IO credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_tooladafruitio_action_getGet one Action with its definition and recent run logs.Read-onlyGet Action
Get one Action with its definition and recent run logs. Returns run_status, validation_status, validation errors, watched feeds and the last run log. Use this to debug an action. Get IDs from adafruitio_actions_list.
Inputs
idintegerrequired- Action ID. Example: 42.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_actions_listList your Adafruit IO Actions (automations triggered by feed data or schedules).Read-onlyList Actions
List your Adafruit IO Actions (automations triggered by feed data or schedules). Returns each action's id, name, run_status and validation_status. Use this to find action IDs. Use adafruitio_action_get to see why an action isn't running.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_activities_by_type_listList recent activity for one kind of object, such as feeds or dashboards.Read-onlyList Activities by Type
List recent activity for one kind of object, such as feeds or dashboards. Returns activity records. Use adafruitio_activities_list for everything.
Inputs
typestringrequired- Object type to filter on, for example feed, group, dashboard or block. Example: feed.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
end_timestring- Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
limitinteger- Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
start_timestring- Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
adafruitio_activities_listList recent activity in your account: creates, updates and deletes of feeds, groups, dashboards and more.Read-onlyList Activities
List recent activity in your account: creates, updates and deletes of feeds, groups, dashboards and more. Returns activity records with action, model and timestamp. Use adafruitio_activities_by_type_list for one kind of object.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
end_timestring- Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
limitinteger- Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
start_timestring- Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
adafruitio_block_getGet one dashboard block.Read-onlyGet Dashboard Block
Get one dashboard block. Returns its visual type, feeds, properties and position. Get block IDs from adafruitio_blocks_list.
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
idstringrequired- Block ID. Example: 1234.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_blocks_listList the blocks (widgets) on a dashboard.Read-onlyList Dashboard Blocks
List the blocks (widgets) on a dashboard. Returns each block's id, name, visual type, feeds and size. Use this to find block IDs.
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_dashboard_getGet one dashboard by key.Read-onlyGet Dashboard
Get one dashboard by key. Returns its name, key, visibility, layout settings and blocks. Get dashboard keys from adafruitio_dashboards_list.
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_dashboards_listList all dashboards in your account.Read-onlyList Dashboards
List all dashboards in your account. Returns each dashboard's id, name, key and visibility. Use this to find dashboard keys.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_data_chart_getGet a feed's data aggregated into time slices, as used by Adafruit IO charts (at most 480 points).Read-onlyGet Feed Chart Data
Get a feed's data aggregated into time slices, as used by Adafruit IO charts (at most 480 points). Returns [timestamp, value] pairs and the parameters used. Use this for trends over hours or days. Use adafruitio_data_list for raw points.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
end_timestring- Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
fieldstring- Aggregate to return per slice: avg, sum, val, min, max or val_count. Example: avg.one of
avgsumvalminmaxval_count hoursinteger- Number of hours to cover, ending now. Ignored when start_time and end_time are given. Example: 24.
rawboolean- Return raw points instead of aggregates. Not compatible with field or resolution. Example: false.
resolutioninteger- Slice size in minutes: 1, 5, 10, 30, 60, 120, 240, 480 or 960. Calculated automatically if omitted. Example: 60.one of
15103060120240480960 start_timestring- Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
adafruitio_data_getGet one data point by ID.Read-onlyGet Data Point
Get one data point by ID. Returns its value, location and timestamps. Get data point IDs from adafruitio_data_list.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
idstringrequired- Data point ID. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_data_last_value_getGet only the latest value of a feed, without moving the queue pointer.Read-onlyGet Last Value
Get only the latest value of a feed, without moving the queue pointer. Returns the value. Use this for a quick current reading. Use adafruitio_data_last_get for the full data point.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
typestring- Response format. Omit for JSON. Example: json.
adafruitio_data_listList data points in a feed, newest first, optionally limited to a time range.Read-onlyList Feed Data
List data points in a feed, newest first, optionally limited to a time range. Returns data points (id, value, created_at, and location when set). Use this for history. Use adafruitio_data_last_get for only the latest value and adafruitio_data_chart_get for aggregated series. Get feed keys from adafruitio_feeds_list.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
beforestring- Paging token from the Link header of the previous page, to fetch older records. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
end_timestring- Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
includestring- Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.
limitinteger- Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
start_timestring- Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
adafruitio_data_previous_getGet the data point before the feed's queue pointer, without moving the pointer.Read-onlyGet Previous Data Point
Get the data point before the feed's queue pointer, without moving the pointer. Returns one data point. Use this when stepping through a feed as a queue with adafruitio_data_next_get.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
includestring- Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.
adafruitio_feed_details_getGet a feed with extra detail, including every group it belongs to and its sharing state.Read-onlyGet Feed Details
Get a feed with extra detail, including every group it belongs to and its sharing state. Returns the detailed feed record. Use adafruitio_feed_get for the basic record.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_feed_getGet one feed by key.Read-onlyGet Feed
Get one feed by key. Returns the feed's name, key, group, last value, visibility and history settings. Use adafruitio_feed_details_get for more detail, such as all its groups.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_feed_webhooks_listList a feed's webhook receivers: the URLs other services post data to.Read-onlyList Webhook Receivers
List a feed's webhook receivers: the URLs other services post data to. Returns each receiver's id, hook URLs, rate limit, expiry and use count. Treat the URLs as secrets. Only the feed owner can list them.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_feeds_listList all feeds in your Adafruit IO account.Read-onlyList Feeds
List all feeds in your Adafruit IO account. Returns each feed's id, name, key, group, last value and settings. Use this to find feed keys. Use adafruitio_feed_get for one feed.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_group_feed_data_listList data points of a feed inside a specific group.Read-onlyList Group Feed Data
List data points of a feed inside a specific group. Returns data points, newest first. Use this when the same feed key exists in more than one group. Otherwise use adafruitio_data_list.
Inputs
feed_keystringrequired- Feed key within the group, from adafruitio_group_feeds_list. Example: temperature.
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
end_timestring- Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
limitinteger- Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
start_timestring- Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.
adafruitio_group_feeds_listList the feeds in one group.Read-onlyList Group Feeds
List the feeds in one group. Returns each feed's name, key and latest value. Use adafruitio_feeds_list for all feeds.
Inputs
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_group_getGet one group by key.Read-onlyGet Group
Get one group by key. Returns the group's name, key, description and feeds. Get group keys from adafruitio_groups_list.
Inputs
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_group_last_values_getGet the latest value of every feed in a group in one call.Read-onlyGet Group Last Values
Get the latest value of every feed in a group in one call. Returns each feed key with its last value. Use this for a device snapshot. Use adafruitio_data_last_value_get for one feed.
Inputs
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
typestring- Response format. Omit for JSON. Example: json.
adafruitio_groups_listList all feed groups in your account.Read-onlyList Groups
List all feed groups in your account. Returns each group's id, name, key and its feeds with their latest values. Use this to find group keys. Use adafruitio_group_get for one group.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_throttle_getGet your data rate limit and how much of it is used right now.Read-onlyGet Rate Limit Status
Get your data rate limit and how much of it is used right now. Returns the per-minute data limit and the current activity count. Use this before sending many data points.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_user_getGet the Adafruit IO user that owns the API key.Read-onlyGet Current User
Get the Adafruit IO user that owns the API key. Returns the username, name, time zone and account limits. Use this first to learn the username every other tool needs.
Inputs
This tool takes no inputs.
adafruitio_action_createCreate an Action, optionally from a definition copied from an existing action.WriteCreate Action
Create an Action, optionally from a definition copied from an existing action. New actions start stopped. Returns the new action. Actions are normally built in the Actions editor at io.adafruit.com. Start it with adafruitio_action_update.
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
bytecodeobject- The action definition with version, settings, triggers and expressions, as produced by the Actions editor (copy it from an existing action). Building one by hand is not practical. Example: {"version": 1, "settings": {}, "triggers": [], "expressions": []}
descriptionstring- Description of the action. Example: Email me when the roof gets hot.
namestring- Name of the action. Example: High temperature alert.
run_statusstring- started to run the action when triggered, stopped to pause it. New actions start stopped. Example: stopped.one of
startedstopped
adafruitio_action_updateRename, start, stop or redefine an Action.WriteUpdate Action
Rename, start, stop or redefine an Action. Send only the fields to change. Returns the updated action. Set run_status to started or stopped to switch it on or off. Get IDs from adafruitio_actions_list.
- Idempotent
Inputs
idintegerrequired- Action ID. Example: 42.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
bytecodeobject- The action definition with version, settings, triggers and expressions, as produced by the Actions editor (copy it from an existing action). Building one by hand is not practical. Example: {"version": 1, "settings": {}, "triggers": [], "expressions": []}
descriptionstring- Description of the action. Example: Email me when the roof gets hot.
namestring- Name of the action. Example: High temperature alert.
run_statusstring- started to run the action when triggered, stopped to pause it. New actions start stopped. Example: stopped.one of
startedstopped
adafruitio_block_createAdd a block (gauge, chart, toggle, slider and so on) to a dashboard and connect it to feeds.WriteCreate Dashboard Block
Add a block (gauge, chart, toggle, slider and so on) to a dashboard and connect it to feeds. Returns the new block. New blocks are placed automatically; size_x and size_y set the size.
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
visual_typestringrequired- Block type. Example: gauge.one of
toggle_buttonslidermomentary_buttongaugeline_charttextcolor_pickermapstreamimageremote_controlmultiline_textrich_texticonindicatornumber_padselectordashboard_linkbatterydividerline_gauge block_feedsarray- Feeds connected to the block. Each item has feed_id (a feed ID, feed key, or group-key.feed-key) and an optional group_id. Example: [{"feed_id": "temperature"}]
columninteger- Grid column (ignored on create; new blocks are placed automatically). Example: 0.
descriptionstring- Description of the block. Example: Roof temperature gauge.
namestring- Display name of the block. Example: Temperature.
propertiesobject- Visual settings; keys depend on visual_type, for example label, minValue, maxValue and decimalPlaces. Values are strings. Example: {"minValue": "0", "maxValue": "100", "label": "Temp"}
rowinteger- Grid row (ignored on create). Example: 0.
size_xinteger- Width in grid units. Defaults to 2. Example: 4.
size_yinteger- Height in grid units. Defaults to 2. Example: 4.
adafruitio_block_updateUpdate a block's type, name, feeds, properties, position or size.WriteUpdate Dashboard Block
Update a block's type, name, feeds, properties, position or size. Send only the fields to change. Returns the updated block. Get block IDs from adafruitio_blocks_list.
- Idempotent
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
idstringrequired- Block ID. Example: 1234.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
block_feedsarray- Feeds connected to the block. Each item has feed_id (a feed ID, feed key, or group-key.feed-key) and an optional group_id. Example: [{"feed_id": "temperature"}]
columninteger- Grid column (ignored on create; new blocks are placed automatically). Example: 0.
descriptionstring- Description of the block. Example: Roof temperature gauge.
namestring- Display name of the block. Example: Temperature.
propertiesobject- Visual settings; keys depend on visual_type, for example label, minValue, maxValue and decimalPlaces. Values are strings. Example: {"minValue": "0", "maxValue": "100", "label": "Temp"}
rowinteger- Grid row (ignored on create). Example: 0.
size_xinteger- Width in grid units. Defaults to 2. Example: 4.
size_yinteger- Height in grid units. Defaults to 2. Example: 4.
visual_typestring- Block type. Example: gauge.one of
toggle_buttonslidermomentary_buttongaugeline_charttextcolor_pickermapstreamimageremote_controlmultiline_textrich_texticonindicatornumber_padselectordashboard_linkbatterydividerline_gauge
adafruitio_dashboard_createCreate a dashboard.WriteCreate Dashboard
Create a dashboard. Returns the new dashboard with its key. Add blocks with adafruitio_block_create.
Inputs
namestringrequired- Display name of the dashboard (max 128 characters). Example: Weather Station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
allow_overlapboolean- Allow blocks to overlap on the grid. Defaults to false. Example: false.
block_bordersboolean- Show borders around blocks. Defaults to true. Example: true.
color_modestring- dark (default) or light. Example: dark.one of
darklight descriptionstring- Description of the dashboard. Example: Roof sensors.
keystring- URL-safe key. Generated from the name if omitted. Example: weather-station.
show_headerboolean- Show a header image. Defaults to false. Example: false.
visibilitystring- private (default) or public. Example: private.one of
privatepublic
adafruitio_dashboard_updateUpdate a dashboard's name, description, key, visibility or display settings.WriteUpdate Dashboard
Update a dashboard's name, description, key, visibility or display settings. Send only the fields to change. Returns the updated dashboard. Get dashboard keys from adafruitio_dashboards_list.
- Idempotent
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
allow_overlapboolean- Allow blocks to overlap on the grid. Defaults to false. Example: false.
block_bordersboolean- Show borders around blocks. Defaults to true. Example: true.
color_modestring- dark (default) or light. Example: dark.one of
darklight descriptionstring- Description of the dashboard. Example: Roof sensors.
keystring- URL-safe key. Generated from the name if omitted. Example: weather-station.
namestring- Display name of the dashboard (max 128 characters). Example: Weather Station.
show_headerboolean- Show a header image. Defaults to false. Example: false.
visibilitystring- private (default) or public. Example: private.one of
privatepublic
adafruitio_data_batch_createSend several values to one feed in one request.WriteCreate Data Points (Batch)
Send several values to one feed in one request. Returns the created data points. Use this to upload buffered readings. Feeds with history off reject batches, and each record counts against your rate limit.
Inputs
dataarrayrequired- Data records. Each needs value and may have lat, lon, ele and created_at (ISO 8601). Example: [{"value": "21.9", "created_at": "2026-01-15T10:00:00Z"}, {"value": "22.4"}]
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_data_createSend a new value to a feed, optionally tagged with a location and timestamp.WriteCreate Data Point
Send a new value to a feed, optionally tagged with a location and timestamp. Returns the created data point with its id. Use this to record one reading or control value. Use adafruitio_data_batch_create for many values at once. Get feed keys from adafruitio_feeds_list.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
valuestringrequired- The value to record. Numbers are sent as text; up to 1 KB when the feed keeps history, 100 KB otherwise. Example: 22.5.
created_atstring- Timestamp for the value (ISO 8601). May be in the past but not in the future. Defaults to now. Example: 2026-01-15T10:00:00Z.
elenumber- Elevation to tag the value with. Example: 12.
latnumber- Latitude to tag the value with. Example: 40.7262.
lonnumber- Longitude to tag the value with. Example: -74.0053.
adafruitio_data_first_getGet the oldest data point in a feed and move the queue pointer to the start.WriteGet First Data Point
Get the oldest data point in a feed and move the queue pointer to the start. Returns one data point. Use this to restart queue processing from the beginning.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
includestring- Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.
adafruitio_data_last_getGet the most recent data point in a feed and move the queue pointer to the end.WriteGet Last Data Point
Get the most recent data point in a feed and move the queue pointer to the end. Returns one data point with value and created_at. Use this to read a feed's current value with its metadata. Use adafruitio_data_last_value_get for just the value.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
includestring- Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.
adafruitio_data_next_getGet the next unprocessed data point in the feed's queue and advance the queue pointer.WriteGet Next Data Point
Get the next unprocessed data point in the feed's queue and advance the queue pointer. Returns one data point, or the first one if processing has not started. Use this to process a feed in order. Use adafruitio_data_last_get for the newest value.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
includestring- Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.
adafruitio_data_updateChange the value, location or timestamp of an existing data point.WriteUpdate Data Point
Change the value, location or timestamp of an existing data point. Returns the updated data point. Get data point IDs from adafruitio_data_list.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
idstringrequired- Data point ID. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
created_atstring- Timestamp for the value (ISO 8601). May be in the past but not in the future. Defaults to now. Example: 2026-01-15T10:00:00Z.
elenumber- Elevation to tag the value with. Example: 12.
latnumber- Latitude to tag the value with. Example: 40.7262.
lonnumber- Longitude to tag the value with. Example: -74.0053.
valuestring- The value to record. Numbers are sent as text; up to 1 KB when the feed keeps history, 100 KB otherwise. Example: 22.5.
adafruitio_feed_createCreate a feed, optionally in a group.WriteCreate Feed
Create a feed, optionally in a group. Returns the new feed with its key. Use this before sending data to a new feed. Use adafruitio_group_feed_create to create it directly in a group.
Inputs
namestringrequired- Display name of the feed. Example: Temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
descriptionstring- Description of the feed. Example: Living room temperature in Celsius.
group_keystring- Group to create the feed in. Defaults to the default group. Example: weather-station.
historyboolean- Whether the feed keeps a history of values. When false only the latest value is kept. Example: true.
keystring- URL-safe feed key. Generated from the name if omitted. Example: temperature.
licensestring- License for the feed's data. Example: CC-BY-4.0.
unit_symbolstring- Unit symbol shown with values. Example: C.
unit_typestring- Unit type label for the feed's values. Example: temperature.
visibilitystring- private (default) or public. Example: private.one of
privatepublic
adafruitio_feed_updateUpdate a feed's name, key, description, visibility, history or units.WriteUpdate Feed
Update a feed's name, key, description, visibility, history or units. Send only the fields to change. Returns the updated feed. Get feed keys from adafruitio_feeds_list.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
descriptionstring- Description of the feed. Example: Living room temperature in Celsius.
historyboolean- Whether the feed keeps a history of values. When false only the latest value is kept. Example: true.
keystring- URL-safe feed key. Generated from the name if omitted. Example: temperature.
licensestring- License for the feed's data. Example: CC-BY-4.0.
namestring- Display name of the feed. Example: Temperature.
unit_symbolstring- Unit symbol shown with values. Example: C.
unit_typestring- Unit type label for the feed's values. Example: temperature.
visibilitystring- private (default) or public. Example: private.one of
privatepublic
adafruitio_feed_webhook_createCreate a webhook receiver so an outside service can post data to a feed.WriteCreate Webhook Receiver
Create a webhook receiver so an outside service can post data to a feed. Returns hook_url (JSON or form value), raw_hook_url (raw body) and notify_hook_url. Use this to connect services such as IFTTT. Anyone with the URL can post to the feed.
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
data_rate_limitinteger- Data points per minute accepted through this receiver, if lower than your account limit. Example: 10.
enabledboolean- Whether the receiver accepts posts. Defaults to true. Example: true.
expire_atstring- Time after which the receiver rejects posts (ISO 8601). Example: 2026-12-31T23:59:59Z.
adafruitio_feed_webhook_updateChange a webhook receiver's rate limit, expiry or enabled state.WriteUpdate Webhook Receiver
Change a webhook receiver's rate limit, expiry or enabled state. Returns the updated receiver. Get receiver IDs from adafruitio_feed_webhooks_list.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
idintegerrequired- Receiver ID. Example: 5.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
data_rate_limitinteger- Data points per minute accepted through this receiver. Example: 10.
enabledboolean- false pauses the receiver, true resumes it. Example: false.
expire_atstring- Time after which the receiver rejects posts (ISO 8601). Example: 2026-12-31T23:59:59Z.
adafruitio_group_createCreate a feed group.WriteCreate Group
Create a feed group. Returns the new group with its key. Use adafruitio_group_feed_add to put existing feeds in it.
Inputs
namestringrequired- Display name of the group. Example: Weather Station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
descriptionstring- Description of the group. Example: Sensors on the roof.
keystring- URL-safe group key. Generated from the name if omitted. Example: weather-station.
adafruitio_group_data_createSend values to several feeds in a group in one request, optionally with one shared location and timestamp.WriteCreate Group Data
Send values to several feeds in a group in one request, optionally with one shared location and timestamp. Returns the created data points. Use this to post a set of readings from one device. Feeds named in feeds are created in the group if missing.
Inputs
feedsarrayrequired- Feed values to write. Each item has the feed key and a value. Example: [{"key": "temperature", "value": "22.5"}, {"key": "humidity", "value": "48"}]
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
created_atstring- Timestamp applied to every value (ISO 8601). Example: 2026-01-15T10:00:00Z.
locationobject- Location applied to every value: lat, lon and optional ele. Example: {"lat": 40.7262, "lon": -74.0053}
adafruitio_group_feed_addAdd an existing feed to a group.WriteAdd Feed to Group
Add an existing feed to a group. Returns the updated group. Use adafruitio_group_feed_remove to take it out.
- Idempotent
Inputs
feed_keystringrequired- Key of the existing feed to add, from adafruitio_feeds_list. Example: temperature.
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_group_feed_createCreate a new feed directly inside a group.WriteCreate Feed in Group
Create a new feed directly inside a group. Returns the new feed. Use adafruitio_group_feed_add to add an existing feed instead.
Inputs
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
namestringrequired- Display name of the feed. Example: Temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
descriptionstring- Description of the feed. Example: Living room temperature in Celsius.
historyboolean- Whether the feed keeps a history of values. When false only the latest value is kept. Example: true.
keystring- URL-safe feed key. Generated from the name if omitted. Example: temperature.
licensestring- License for the feed's data. Example: CC-BY-4.0.
unit_symbolstring- Unit symbol shown with values. Example: C.
unit_typestring- Unit type label for the feed's values. Example: temperature.
visibilitystring- private (default) or public. Example: private.one of
privatepublic
adafruitio_group_feed_data_createSend a new value to a feed inside a specific group.WriteCreate Group Feed Data
Send a new value to a feed inside a specific group. Returns the created data point. Use this for feeds outside the default group. Use adafruitio_data_create for default-group feeds.
Inputs
feed_keystringrequired- Feed key within the group, from adafruitio_group_feeds_list. Example: temperature.
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
valuestringrequired- The value to record. Numbers are sent as text; up to 1 KB when the feed keeps history, 100 KB otherwise. Example: 22.5.
created_atstring- Timestamp for the value (ISO 8601). May be in the past but not in the future. Defaults to now. Example: 2026-01-15T10:00:00Z.
elenumber- Elevation to tag the value with. Example: 12.
latnumber- Latitude to tag the value with. Example: 40.7262.
lonnumber- Longitude to tag the value with. Example: -74.0053.
adafruitio_group_feed_removeRemove a feed from a group.WriteRemove Feed from Group
Remove a feed from a group. The feed and its data are kept. Returns the updated group. Get feed keys from adafruitio_group_feeds_list.
- Idempotent
Inputs
feed_keystringrequired- Key of the feed to remove, from adafruitio_group_feeds_list. Example: temperature.
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_group_updateUpdate a group's name, key or description.WriteUpdate Group
Update a group's name, key or description. Send only the fields to change. Returns the updated group. Get group keys from adafruitio_groups_list.
- Idempotent
Inputs
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
descriptionstring- Description of the group. Example: Sensors on the roof.
keystring- URL-safe group key. Generated from the name if omitted. Example: weather-station.
namestring- Display name of the group. Example: Weather Station.
adafruitio_action_deleteDelete an Action.DestructiveDelete Action
Delete an Action. Returns an empty response on success. Use adafruitio_action_update with run_status stopped to pause it instead.
- Idempotent
Inputs
idintegerrequired- Action ID. Example: 42.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_activities_deleteDelete your whole activity history.DestructiveDelete All Activities
Delete your whole activity history. Feeds, data and other objects are not affected. Returns an empty response on success. This cannot be undone.
- Idempotent
Inputs
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_block_deleteRemove a block from a dashboard.DestructiveDelete Dashboard Block
Remove a block from a dashboard. Returns the deleted block. Get block IDs from adafruitio_blocks_list.
- Idempotent
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
idstringrequired- Block ID. Example: 1234.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_dashboard_deleteDelete a dashboard and all of its blocks.DestructiveDelete Dashboard
Delete a dashboard and all of its blocks. Feeds and data are kept. Returns the deleted dashboard. Get dashboard keys from adafruitio_dashboards_list.
- Idempotent
Inputs
dashboard_keystringrequired- Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_data_deleteDelete one data point from a feed.DestructiveDelete Data Point
Delete one data point from a feed. Returns an empty response on success. Get data point IDs from adafruitio_data_list.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
idstringrequired- Data point ID. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_feed_deleteDelete a feed and all of its data.DestructiveDelete Feed
Delete a feed and all of its data. Returns an empty response on success. Get feed keys from adafruitio_feeds_list.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_feed_webhook_deleteDelete a webhook receiver.DestructiveDelete Webhook Receiver
Delete a webhook receiver. Its URLs stop working immediately. Returns the deleted receiver. Get receiver IDs from adafruitio_feed_webhooks_list.
- Idempotent
Inputs
feed_keystringrequired- Feed key: the URL-safe key of the feed (not its display name), from adafruitio_feeds_list. Use group-key.feed-key for a feed outside the default group. Example: temperature.
idintegerrequired- Receiver ID. Example: 5.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
adafruitio_group_deleteDelete a feed group.DestructiveDelete Group
Delete a feed group. Returns an empty response on success. Get group keys from adafruitio_groups_list.
- Idempotent
Inputs
group_keystringrequired- Group key, from adafruitio_groups_list. Example: weather-station.
usernamestringrequired- Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
No tools match.