---
canonical_url: "https://docs.composio.dev/toolkits/adafruit_io"
markdown_url: "https://docs.composio.dev/toolkits/adafruit_io.md"
product: "platform"
version: null
last_updated: null
---

# Adafruit IO

Adafruit IO is a cloud platform for storing, visualizing, and acting on data from connected devices and Internet of Things projects.

- **Category:** internet of things
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 21
- **Triggers:** 0
- **Slug:** `ADAFRUIT_IO`
- **Version:** 00000000_00

## Tools

### Add Feeds to Group

**Slug:** `ADAFRUIT_IO_ADD_FEEDS_TO_GROUP`

Sequentially add 1-10 existing feeds to one group using one documented provider request per feed. This is non-atomic: processing stops after the first failed or ambiguous attempt, while earlier successes remain applied and are returned with the last confirmed normalized group state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feed_keys` | array | Yes | One to 10 unique exact existing feed keys. The bound matches the observed Free-plan limit of 10 feeds; one provider request is made per key. |
| `group_key` | string | Yes | Exact destination group key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Dashboard

**Slug:** `ADAFRUIT_IO_CREATE_DASHBOARD`

Create a dashboard for visualizing and controlling feed data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Dashboard display name. |
| `visibility` | string ("private" | "public") | No | Dashboard visibility. |
| `description` | string | No | Human-readable dashboard description. |
| `show_header` | boolean | No | Whether to show the dashboard header. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Feed

**Slug:** `ADAFRUIT_IO_CREATE_FEED`

Create a feed, optionally within an existing group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Feed display name; Adafruit IO derives a lowercase hyphenated key when creating. |
| `enabled` | boolean | No | Whether the feed is enabled. |
| `history` | boolean | No | Whether Adafruit IO stores feed history. |
| `group_key` | string | No | Existing group key in which to create the feed. |
| `unit_type` | string | No | Unit category, such as temperature or pressure. |
| `visibility` | string ("private" | "public") | No | Feed visibility. |
| `description` | string | No | Human-readable feed description. |
| `unit_symbol` | string | No | Short unit symbol displayed with values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Group

**Slug:** `ADAFRUIT_IO_CREATE_GROUP`

Create a group for organizing feeds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Group display name. |
| `description` | string | No | Human-readable group description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Dashboard

**Slug:** `ADAFRUIT_IO_DELETE_DASHBOARD`

Permanently delete one dashboard by exact key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dashboard_key` | string | Yes | Exact key of the dashboard to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Data Point

**Slug:** `ADAFRUIT_IO_DELETE_DATA_POINT`

Permanently delete one feed data point by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data_id` | string | Yes | Exact ID of the data point to permanently delete. |
| `feed_key` | string | Yes | Exact key of the feed containing the data point. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Data Points

**Slug:** `ADAFRUIT_IO_DELETE_DATA_POINTS`

Permanently delete 1-30 feed data points sequentially through Adafruit IO's single-data-point DELETE endpoint, bounded by the Free-plan limit of 30 data mutations per minute. This operation is not atomic: each ID has an independent outcome, and successful earlier deletions are not rolled back. Processing may continue after an independent malformed-ID or not-found response, but stops after authentication, permission, rate-limit, server, unexpected, or ambiguous transport failures; remaining IDs are marked not_attempted.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data_ids` | array | Yes | Ordered IDs of 1-30 data points to permanently delete, bounded by the Free-plan limit of 30 data mutations per minute. Each ID is deleted with a separate sequential provider request. |
| `feed_key` | string | Yes | Exact key of the feed containing the data points. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Feed

**Slug:** `ADAFRUIT_IO_DELETE_FEED`

Permanently delete one feed and its retained data by exact feed key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feed_key` | string | Yes | Exact key of the feed to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Group

**Slug:** `ADAFRUIT_IO_DELETE_GROUP`

Permanently delete one group by exact key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_key` | string | Yes | Exact key of the group to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Status

**Slug:** `ADAFRUIT_IO_GET_ACCOUNT_STATUS`

Return compact identity, plan limits, and current data-write throttle usage for the connected Adafruit IO account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dashboards

**Slug:** `ADAFRUIT_IO_GET_DASHBOARDS`

List dashboards, or retrieve one dashboard and its blocks by key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dashboard_key` | string | No | Exact dashboard key to retrieve; omit to list all dashboards. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Data Point

**Slug:** `ADAFRUIT_IO_GET_DATA_POINT`

Retrieve one feed data point by its exact ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data_id` | string | Yes | Exact data point ID returned by publish or list. |
| `include` | array | No | Optional fields to request; allowed values are exactly value, lat, lon, ele, id, created_at. Omit for the full record. |
| `feed_key` | string | Yes | Exact feed key containing the point. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Feeds

**Slug:** `ADAFRUIT_IO_GET_FEEDS`

List feeds, or retrieve one feed by key with optional data summary details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feed_key` | string | No | Exact feed key to retrieve; omit to list all feeds. |
| `include_details` | boolean | No | When feed_key is provided, include first and last data summaries, data count, dashboards, and actions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Groups

**Slug:** `ADAFRUIT_IO_GET_GROUPS`

List groups with feed summaries, or retrieve one group by key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_key` | string | No | Exact group key to retrieve; omit to list all groups. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Feed Data

**Slug:** `ADAFRUIT_IO_LIST_FEED_DATA`

Return one newest-first page of feed data with an opaque cursor for the next older page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum points in this page (1-1000). |
| `include` | array | No | Data fields to request from Adafruit IO; allowed values are exactly value, lat, lon, ele, id, created_at. |
| `end_time` | string | No | Only return points at or before this ISO 8601 time. |
| `feed_key` | string | Yes | Exact feed key whose data to list. |
| `start_time` | string | No | Only return points at or after this ISO 8601 time. |
| `next_cursor` | string | No | Continuation cursor from a previous response's next_cursor. Omit for the first page; pass the returned value back verbatim to fetch the next page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Publish Feed Data

**Slug:** `ADAFRUIT_IO_PUBLISH_FEED_DATA`

Publish one or multiple timestamped values to a feed, using the batch endpoint only when multiple points are supplied.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | array | Yes | One to 30 data points to publish. Each point requires a value and may include location and a timestamp. |
| `feed_key` | string | Yes | Exact key of the destination feed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Feeds from Group

**Slug:** `ADAFRUIT_IO_REMOVE_FEEDS_FROM_GROUP`

Sequentially remove 1-10 feeds from one group using one documented provider request per feed. This is non-atomic: processing stops after the first failed or ambiguous attempt, while earlier successes remain applied and are returned with the last confirmed normalized group state.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `feed_keys` | array | Yes | One to 10 unique exact existing feed keys. The bound matches the observed Free-plan limit of 10 feeds; one provider request is made per key. |
| `group_key` | string | Yes | Exact destination group key. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Dashboard

**Slug:** `ADAFRUIT_IO_UPDATE_DASHBOARD`

Update an existing dashboard by exact dashboard key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Dashboard display name. |
| `visibility` | string ("private" | "public") | No | Dashboard visibility. |
| `description` | string | No | Human-readable dashboard description. |
| `show_header` | boolean | No | Whether to show the dashboard header. |
| `dashboard_key` | string | Yes | Exact key of the existing dashboard to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Data Point

**Slug:** `ADAFRUIT_IO_UPDATE_DATA_POINT`

Replace the value and optional metadata of one existing feed data point.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ele` | string | No | Optional elevation as a number or numeric string. |
| `lat` | string | No | Optional latitude as a number or numeric string. |
| `lon` | string | No | Optional longitude as a number or numeric string. |
| `value` | string | Yes | Replacement data point value. |
| `data_id` | string | Yes | Exact data point ID to update. |
| `feed_key` | string | Yes | Exact feed key containing the data point. |
| `created_at` | string | No | Optional replacement timestamp in ISO 8601 format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Feed

**Slug:** `ADAFRUIT_IO_UPDATE_FEED`

Update an existing feed by exact feed key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Feed display name; Adafruit IO derives a lowercase hyphenated key when creating. |
| `enabled` | boolean | No | Whether the feed is enabled. |
| `history` | boolean | No | Whether Adafruit IO stores feed history. |
| `feed_key` | string | Yes | Exact key of the existing feed to update. |
| `unit_type` | string | No | Unit category, such as temperature or pressure. |
| `visibility` | string ("private" | "public") | No | Feed visibility. |
| `description` | string | No | Human-readable feed description. |
| `unit_symbol` | string | No | Short unit symbol displayed with values. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Group

**Slug:** `ADAFRUIT_IO_UPDATE_GROUP`

Update an existing group by exact group key.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Group display name. |
| `group_key` | string | Yes | Exact key of the existing group to update. |
| `description` | string | No | Human-readable group description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |