> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Adafruit IO

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.

**Authentication:** API Key
**Categories:** Analytics, Developer Tools
**Tools:** 59: 25 read, 25 write, 9 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=ADAFRUITIO)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Adafruit IO connection

   In **AgentKit > Connections**, create an Adafruit IO connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   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.actions

   const connector = 'adafruitio'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'adafruitio_user_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_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.actions

   connection_name = "adafruitio"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="adafruitio_user_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Adafruit IO credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'adafruitio_action_get',
  toolInput: {
    id: 42,
    username: '<username>',
  },
  connector: 'adafruitio',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="adafruitio_action_get",
    tool_input={
        "id": 42,
        "username": "<username>",
    },
    connection_name="adafruitio",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `adafruitio_action_get`

Get Action · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): Action ID. Example: 42.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"id":42,"username":"<username>"}`

### `adafruitio_actions_list`

List Actions · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"username":"<username>"}`

### `adafruitio_activities_by_type_list`

List Activities by Type · Read-only

List recent activity for one kind of object, such as feeds or dashboards.
Returns activity records.
Use adafruitio_activities_list for everything.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `type` (`string`, required): Object type to filter on, for example feed, group, dashboard or block. Example: feed.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `end_time` (`string`, optional): Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
- `limit` (`integer`, optional): Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
- `start_time` (`string`, optional): Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.

Example input: `{"type":"<type>","username":"<username>"}`

### `adafruitio_activities_list`

List Activities · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `end_time` (`string`, optional): Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
- `limit` (`integer`, optional): Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
- `start_time` (`string`, optional): Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.

Example input: `{"username":"<username>"}`

### `adafruitio_block_get`

Get Dashboard Block · Read-only

Get one dashboard block.
Returns its visual type, feeds, properties and position.
Get block IDs from adafruitio_blocks_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `id` (`string`, required): Block ID. Example: 1234.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"dashboard_key":"<dashboard_key>","id":"<id>","username":"<username>"}`

### `adafruitio_blocks_list`

List Dashboard Blocks · Read-only

List the blocks (widgets) on a dashboard.
Returns each block's id, name, visual type, feeds and size.
Use this to find block IDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"dashboard_key":"<dashboard_key>","username":"<username>"}`

### `adafruitio_dashboard_get`

Get Dashboard · Read-only

Get one dashboard by key.
Returns its name, key, visibility, layout settings and blocks.
Get dashboard keys from adafruitio_dashboards_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"dashboard_key":"<dashboard_key>","username":"<username>"}`

### `adafruitio_dashboards_list`

List Dashboards · Read-only

List all dashboards in your account.
Returns each dashboard's id, name, key and visibility.
Use this to find dashboard keys.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"username":"<username>"}`

### `adafruitio_data_chart_get`

Get Feed Chart Data · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `end_time` (`string`, optional): Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
- `field` (`string`, optional): Aggregate to return per slice: avg, sum, val, min, max or val_count. Example: avg. One of: `avg`, `sum`, `val`, `min`, `max`, `val_count`.
- `hours` (`integer`, optional): Number of hours to cover, ending now. Ignored when start_time and end_time are given. Example: 24.
- `raw` (`boolean`, optional): Return raw points instead of aggregates. Not compatible with field or resolution. Example: false.
- `resolution` (`integer`, optional): Slice size in minutes: 1, 5, 10, 30, 60, 120, 240, 480 or 960. Calculated automatically if omitted. Example: 60. One of: `1`, `5`, `10`, `30`, `60`, `120`, `240`, `480`, `960`.
- `start_time` (`string`, optional): Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_get`

Get Data Point · Read-only

Get one data point by ID.
Returns its value, location and timestamps.
Get data point IDs from adafruitio_data_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`string`, required): Data point ID. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","id":"<id>","username":"<username>"}`

### `adafruitio_data_last_value_get`

Get Last Value · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `type` (`string`, optional): Response format. Omit for JSON. Example: json.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_list`

List Feed Data · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `before` (`string`, optional): Paging token from the Link header of the previous page, to fetch older records. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
- `end_time` (`string`, optional): Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
- `include` (`string`, optional): Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.
- `limit` (`integer`, optional): Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
- `start_time` (`string`, optional): Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_previous_get`

Get Previous Data Point · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `include` (`string`, optional): Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_details_get`

Get Feed Details · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_get`

Get Feed · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_shares_list`

List Feed Shares · Read-only

List the pending and approved shares of a feed, newest first.
Returns each share's id, user, level and status.
Use this to see who can access a feed. Only the feed owner can list shares.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_webhooks_list`

List Webhook Receivers · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feeds_list`

List Feeds · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"username":"<username>"}`

### `adafruitio_group_feed_data_list`

List Group Feed Data · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): Feed key within the group, from adafruitio_group_feeds_list. Example: temperature.
- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `end_time` (`string`, optional): Only records created before this time (ISO 8601). Example: 2026-01-31T23:59:59Z.
- `limit` (`integer`, optional): Maximum number of records to return. Adafruit IO defaults to 100 and allows up to 1000. Example: 100.
- `start_time` (`string`, optional): Only records created after this time (ISO 8601). Example: 2026-01-01T00:00:00Z.

Example input: `{"feed_key":"<feed_key>","group_key":"<group_key>","username":"<username>"}`

### `adafruitio_group_feeds_list`

List Group Feeds · Read-only

List the feeds in one group.
Returns each feed's name, key and latest value.
Use adafruitio_feeds_list for all feeds.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"group_key":"<group_key>","username":"<username>"}`

### `adafruitio_group_get`

Get Group · Read-only

Get one group by key.
Returns the group's name, key, description and feeds.
Get group keys from adafruitio_groups_list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"group_key":"<group_key>","username":"<username>"}`

### `adafruitio_group_last_values_get`

Get Group Last Values · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `type` (`string`, optional): Response format. Omit for JSON. Example: json.

Example input: `{"group_key":"<group_key>","username":"<username>"}`

### `adafruitio_groups_list`

List Groups · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"username":"<username>"}`

### `adafruitio_throttle_get`

Get Rate Limit Status · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"username":"<username>"}`

### `adafruitio_user_get`

Get Current User · Read-only

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.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `adafruitio_action_create`

Create Action · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `bytecode` (`object`, optional): 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": []}
- `description` (`string`, optional): Description of the action. Example: Email me when the roof gets hot.
- `name` (`string`, optional): Name of the action. Example: High temperature alert.
- `run_status` (`string`, optional): started to run the action when triggered, stopped to pause it. New actions start stopped. Example: stopped. One of: `started`, `stopped`.

Example input: `{"username":"<username>"}`

### `adafruitio_action_update`

Update Action · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): Action ID. Example: 42.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `bytecode` (`object`, optional): 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": []}
- `description` (`string`, optional): Description of the action. Example: Email me when the roof gets hot.
- `name` (`string`, optional): Name of the action. Example: High temperature alert.
- `run_status` (`string`, optional): started to run the action when triggered, stopped to pause it. New actions start stopped. Example: stopped. One of: `started`, `stopped`.

Example input: `{"id":42,"username":"<username>"}`

### `adafruitio_block_create`

Create Dashboard Block · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `visual_type` (`string`, required): Block type. Example: gauge. One of: `toggle_button`, `slider`, `momentary_button`, `gauge`, `line_chart`, `text`, `color_picker`, `map`, `stream`, `image`, `remote_control`, `multiline_text`, `rich_text`, `icon`, `indicator`, `number_pad`, `selector`, `dashboard_link`, `battery`, `divider`, `line_gauge`.
- `block_feeds` (`array`, optional): 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"}]
- `column` (`integer`, optional): Grid column (ignored on create; new blocks are placed automatically). Example: 0.
- `description` (`string`, optional): Description of the block. Example: Roof temperature gauge.
- `name` (`string`, optional): Display name of the block. Example: Temperature.
- `properties` (`object`, optional): Visual settings; keys depend on visual_type, for example label, minValue, maxValue and decimalPlaces. Values are strings. Example: {"minValue": "0", "maxValue": "100", "label": "Temp"}
- `row` (`integer`, optional): Grid row (ignored on create). Example: 0.
- `size_x` (`integer`, optional): Width in grid units. Defaults to 2. Example: 4.
- `size_y` (`integer`, optional): Height in grid units. Defaults to 2. Example: 4.

Example input: `{"dashboard_key":"<dashboard_key>","username":"<username>","visual_type":"toggle_button"}`

### `adafruitio_block_update`

Update Dashboard Block · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `id` (`string`, required): Block ID. Example: 1234.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `block_feeds` (`array`, optional): 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"}]
- `column` (`integer`, optional): Grid column (ignored on create; new blocks are placed automatically). Example: 0.
- `description` (`string`, optional): Description of the block. Example: Roof temperature gauge.
- `name` (`string`, optional): Display name of the block. Example: Temperature.
- `properties` (`object`, optional): Visual settings; keys depend on visual_type, for example label, minValue, maxValue and decimalPlaces. Values are strings. Example: {"minValue": "0", "maxValue": "100", "label": "Temp"}
- `row` (`integer`, optional): Grid row (ignored on create). Example: 0.
- `size_x` (`integer`, optional): Width in grid units. Defaults to 2. Example: 4.
- `size_y` (`integer`, optional): Height in grid units. Defaults to 2. Example: 4.
- `visual_type` (`string`, optional): Block type. Example: gauge. One of: `toggle_button`, `slider`, `momentary_button`, `gauge`, `line_chart`, `text`, `color_picker`, `map`, `stream`, `image`, `remote_control`, `multiline_text`, `rich_text`, `icon`, `indicator`, `number_pad`, `selector`, `dashboard_link`, `battery`, `divider`, `line_gauge`.

Example input: `{"dashboard_key":"<dashboard_key>","id":"<id>","username":"<username>"}`

### `adafruitio_dashboard_create`

Create Dashboard · Write

Create a dashboard.
Returns the new dashboard with its key.
Add blocks with adafruitio_block_create.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Display name of the dashboard (max 128 characters). Example: Weather Station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `allow_overlap` (`boolean`, optional): Allow blocks to overlap on the grid. Defaults to false. Example: false.
- `block_borders` (`boolean`, optional): Show borders around blocks. Defaults to true. Example: true.
- `color_mode` (`string`, optional): dark (default) or light. Example: dark. One of: `dark`, `light`.
- `description` (`string`, optional): Description of the dashboard. Example: Roof sensors.
- `key` (`string`, optional): URL-safe key. Generated from the name if omitted. Example: weather-station.
- `show_header` (`boolean`, optional): Show a header image. Defaults to false. Example: false.
- `visibility` (`string`, optional): private (default) or public. Example: private. One of: `private`, `public`.

Example input: `{"name":"<name>","username":"<username>"}`

### `adafruitio_dashboard_update`

Update Dashboard · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `allow_overlap` (`boolean`, optional): Allow blocks to overlap on the grid. Defaults to false. Example: false.
- `block_borders` (`boolean`, optional): Show borders around blocks. Defaults to true. Example: true.
- `color_mode` (`string`, optional): dark (default) or light. Example: dark. One of: `dark`, `light`.
- `description` (`string`, optional): Description of the dashboard. Example: Roof sensors.
- `key` (`string`, optional): URL-safe key. Generated from the name if omitted. Example: weather-station.
- `name` (`string`, optional): Display name of the dashboard (max 128 characters). Example: Weather Station.
- `show_header` (`boolean`, optional): Show a header image. Defaults to false. Example: false.
- `visibility` (`string`, optional): private (default) or public. Example: private. One of: `private`, `public`.

Example input: `{"dashboard_key":"<dashboard_key>","username":"<username>"}`

### `adafruitio_data_batch_create`

Create Data Points (Batch) · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `data` (`array`, required): 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_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"data":[{"value":"21.9","created_at":"2026-01-15T10:00:00Z"},{"value":"22.4"}],"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_create`

Create Data Point · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `value` (`string`, required): 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_at` (`string`, optional): 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.
- `ele` (`number`, optional): Elevation to tag the value with. Example: 12.
- `lat` (`number`, optional): Latitude to tag the value with. Example: 40.7262.
- `lon` (`number`, optional): Longitude to tag the value with. Example: -74.0053.

Example input: `{"feed_key":"<feed_key>","username":"<username>","value":"<value>"}`

### `adafruitio_data_first_get`

Get First Data Point · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `include` (`string`, optional): Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_last_get`

Get Last Data Point · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `include` (`string`, optional): Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_next_get`

Get Next Data Point · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `include` (`string`, optional): Comma-separated data fields to return: value, lat, lon, ele, id and created_at. Example: value,created_at.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_data_update`

Update Data Point · Write

Change the value, location or timestamp of an existing data point.
Returns the updated data point.
Get data point IDs from adafruitio_data_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`string`, required): Data point ID. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `created_at` (`string`, optional): 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.
- `ele` (`number`, optional): Elevation to tag the value with. Example: 12.
- `lat` (`number`, optional): Latitude to tag the value with. Example: 40.7262.
- `lon` (`number`, optional): Longitude to tag the value with. Example: -74.0053.
- `value` (`string`, optional): The value to record. Numbers are sent as text; up to 1 KB when the feed keeps history, 100 KB otherwise. Example: 22.5.

Example input: `{"feed_key":"<feed_key>","id":"<id>","username":"<username>"}`

### `adafruitio_feed_create`

Create Feed · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Display name of the feed. Example: Temperature.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `description` (`string`, optional): Description of the feed. Example: Living room temperature in Celsius.
- `group_key` (`string`, optional): Group to create the feed in. Defaults to the default group. Example: weather-station.
- `history` (`boolean`, optional): Whether the feed keeps a history of values. When false only the latest value is kept. Example: true.
- `key` (`string`, optional): URL-safe feed key. Generated from the name if omitted. Example: temperature.
- `license` (`string`, optional): License for the feed's data. Example: CC-BY-4.0.
- `unit_symbol` (`string`, optional): Unit symbol shown with values. Example: C.
- `unit_type` (`string`, optional): Unit type label for the feed's values. Example: temperature.
- `visibility` (`string`, optional): private (default) or public. Example: private. One of: `private`, `public`.

Example input: `{"name":"<name>","username":"<username>"}`

### `adafruitio_feed_share_create`

Share Feed · Write

Invite another Adafruit IO user, by username or email, to read or write one of your feeds.
Returns the share with its id and pending status.
Use this to give someone access. Non-users get an invitation email. At most 10 pending shares are allowed.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `feed_key` (`string`, required): 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.
- `user_email` (`string`, required): Username or email address of the person to share with. Example: friend@example.com.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `level` (`string`, optional): readable (default) or writable. Example: readable. One of: `readable`, `writable`.

Example input: `{"feed_key":"<feed_key>","user_email":"<user_email>","username":"<username>"}`

### `adafruitio_feed_share_update`

Update Feed Share · Write

Change a feed share's access level. An approved share changes immediately.
Returns the updated share.
Get share IDs from adafruitio_feed_shares_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`integer`, required): Share ID. Example: 17.
- `level` (`string`, required): readable or writable. Example: writable. One of: `readable`, `writable`.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","id":17,"level":"readable","username":"<username>"}`

### `adafruitio_feed_update`

Update Feed · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `description` (`string`, optional): Description of the feed. Example: Living room temperature in Celsius.
- `history` (`boolean`, optional): Whether the feed keeps a history of values. When false only the latest value is kept. Example: true.
- `key` (`string`, optional): URL-safe feed key. Generated from the name if omitted. Example: temperature.
- `license` (`string`, optional): License for the feed's data. Example: CC-BY-4.0.
- `name` (`string`, optional): Display name of the feed. Example: Temperature.
- `unit_symbol` (`string`, optional): Unit symbol shown with values. Example: C.
- `unit_type` (`string`, optional): Unit type label for the feed's values. Example: temperature.
- `visibility` (`string`, optional): private (default) or public. Example: private. One of: `private`, `public`.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_webhook_create`

Create Webhook Receiver · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): 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_limit` (`integer`, optional): Data points per minute accepted through this receiver, if lower than your account limit. Example: 10.
- `enabled` (`boolean`, optional): Whether the receiver accepts posts. Defaults to true. Example: true.
- `expire_at` (`string`, optional): Time after which the receiver rejects posts (ISO 8601). Example: 2026-12-31T23:59:59Z.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_webhook_update`

Update Webhook Receiver · Write

Change a webhook receiver's rate limit, expiry or enabled state.
Returns the updated receiver.
Get receiver IDs from adafruitio_feed_webhooks_list.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`integer`, required): Receiver ID. Example: 5.
- `username` (`string`, required): 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_limit` (`integer`, optional): Data points per minute accepted through this receiver. Example: 10.
- `enabled` (`boolean`, optional): false pauses the receiver, true resumes it. Example: false.
- `expire_at` (`string`, optional): Time after which the receiver rejects posts (ISO 8601). Example: 2026-12-31T23:59:59Z.

Example input: `{"feed_key":"<feed_key>","id":5,"username":"<username>"}`

### `adafruitio_group_create`

Create Group · Write

Create a feed group.
Returns the new group with its key.
Use adafruitio_group_feed_add to put existing feeds in it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Display name of the group. Example: Weather Station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `description` (`string`, optional): Description of the group. Example: Sensors on the roof.
- `key` (`string`, optional): URL-safe group key. Generated from the name if omitted. Example: weather-station.

Example input: `{"name":"<name>","username":"<username>"}`

### `adafruitio_group_data_create`

Create Group Data · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `feeds` (`array`, required): Feed values to write. Each item has the feed key and a value. Example: [{"key": "temperature", "value": "22.5"}, {"key": "humidity", "value": "48"}]
- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `created_at` (`string`, optional): Timestamp applied to every value (ISO 8601). Example: 2026-01-15T10:00:00Z.
- `location` (`object`, optional): Location applied to every value: lat, lon and optional ele. Example: {"lat": 40.7262, "lon": -74.0053}

Example input: `{"feeds":[{"key":"temperature","value":"22.5"},{"key":"humidity","value":"48"}],"group_key":"<group_key>","username":"<username>"}`

### `adafruitio_group_feed_add`

Add Feed to Group · Write

Add an existing feed to a group.
Returns the updated group.
Use adafruitio_group_feed_remove to take it out.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): Key of the existing feed to add, from adafruitio_feeds_list. Example: temperature.
- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","group_key":"<group_key>","username":"<username>"}`

### `adafruitio_group_feed_create`

Create Feed in Group · Write

Create a new feed directly inside a group.
Returns the new feed.
Use adafruitio_group_feed_add to add an existing feed instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `name` (`string`, required): Display name of the feed. Example: Temperature.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `description` (`string`, optional): Description of the feed. Example: Living room temperature in Celsius.
- `history` (`boolean`, optional): Whether the feed keeps a history of values. When false only the latest value is kept. Example: true.
- `key` (`string`, optional): URL-safe feed key. Generated from the name if omitted. Example: temperature.
- `license` (`string`, optional): License for the feed's data. Example: CC-BY-4.0.
- `unit_symbol` (`string`, optional): Unit symbol shown with values. Example: C.
- `unit_type` (`string`, optional): Unit type label for the feed's values. Example: temperature.
- `visibility` (`string`, optional): private (default) or public. Example: private. One of: `private`, `public`.

Example input: `{"group_key":"<group_key>","name":"<name>","username":"<username>"}`

### `adafruitio_group_feed_data_create`

Create Group Feed Data · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `feed_key` (`string`, required): Feed key within the group, from adafruitio_group_feeds_list. Example: temperature.
- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `value` (`string`, required): 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_at` (`string`, optional): 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.
- `ele` (`number`, optional): Elevation to tag the value with. Example: 12.
- `lat` (`number`, optional): Latitude to tag the value with. Example: 40.7262.
- `lon` (`number`, optional): Longitude to tag the value with. Example: -74.0053.

Example input: `{"feed_key":"<feed_key>","group_key":"<group_key>","username":"<username>","value":"<value>"}`

### `adafruitio_group_feed_remove`

Remove Feed from Group · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): Key of the feed to remove, from adafruitio_group_feeds_list. Example: temperature.
- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","group_key":"<group_key>","username":"<username>"}`

### `adafruitio_group_update`

Update Group · Write

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.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.
- `description` (`string`, optional): Description of the group. Example: Sensors on the roof.
- `key` (`string`, optional): URL-safe group key. Generated from the name if omitted. Example: weather-station.
- `name` (`string`, optional): Display name of the group. Example: Weather Station.

Example input: `{"group_key":"<group_key>","username":"<username>"}`

### `adafruitio_action_delete`

Delete Action · Destructive

Delete an Action.
Returns an empty response on success.
Use adafruitio_action_update with run_status stopped to pause it instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`integer`, required): Action ID. Example: 42.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"id":42,"username":"<username>"}`

### `adafruitio_activities_delete`

Delete All Activities · Destructive

Delete your whole activity history. Feeds, data and other objects are not affected.
Returns an empty response on success.
This cannot be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"username":"<username>"}`

### `adafruitio_block_delete`

Delete Dashboard Block · Destructive

Remove a block from a dashboard.
Returns the deleted block.
Get block IDs from adafruitio_blocks_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `id` (`string`, required): Block ID. Example: 1234.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"dashboard_key":"<dashboard_key>","id":"<id>","username":"<username>"}`

### `adafruitio_dashboard_delete`

Delete Dashboard · Destructive

Delete a dashboard and all of its blocks. Feeds and data are kept.
Returns the deleted dashboard.
Get dashboard keys from adafruitio_dashboards_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `dashboard_key` (`string`, required): Dashboard key, from adafruitio_dashboards_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"dashboard_key":"<dashboard_key>","username":"<username>"}`

### `adafruitio_data_delete`

Delete Data Point · Destructive

Delete one data point from a feed.
Returns an empty response on success.
Get data point IDs from adafruitio_data_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`string`, required): Data point ID. Example: 0F2KZ9X4Q1HV7T3Y8BXW5M6N2R.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","id":"<id>","username":"<username>"}`

### `adafruitio_feed_delete`

Delete Feed · Destructive

Delete a feed and all of its data.
Returns an empty response on success.
Get feed keys from adafruitio_feeds_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","username":"<username>"}`

### `adafruitio_feed_share_delete`

Delete Feed Share · Destructive

Delete a feed share and revoke the user's access. The feed and its data are kept.
Returns the deleted share.
Get share IDs from adafruitio_feed_shares_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`integer`, required): Share ID. Example: 17.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","id":17,"username":"<username>"}`

### `adafruitio_feed_webhook_delete`

Delete Webhook Receiver · Destructive

Delete a webhook receiver. Its URLs stop working immediately.
Returns the deleted receiver.
Get receiver IDs from adafruitio_feed_webhooks_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `feed_key` (`string`, required): 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.
- `id` (`integer`, required): Receiver ID. Example: 5.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"feed_key":"<feed_key>","id":5,"username":"<username>"}`

### `adafruitio_group_delete`

Delete Group · Destructive

Delete a feed group.
Returns an empty response on success.
Get group keys from adafruitio_groups_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `group_key` (`string`, required): Group key, from adafruitio_groups_list. Example: weather-station.
- `username` (`string`, required): Your Adafruit IO username, the owner of the API key (case-sensitive). Get it from adafruitio_user_get if unsure. Example: jane_doe.

Example input: `{"group_key":"<group_key>","username":"<username>"}`

## Related

Other Analytics connectors ([all 177](/agentkit/connectors/?category=analytics)):

- [Google Sheets](/agentkit/connectors/googlesheets/): Scalekit connector, OAuth, 48 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [AWS Redshift](/agentkit/connectors/redshift/): Scalekit connector, Trusted identity provider, 10 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
