{ "opencollection": "1.0.0", "info": { "name": "Adafruit IO REST Activities Feeds API", "version": "2.0.0" }, "request": { "auth": { "type": "apikey", "key": "X-AIO-Key", "value": "{{X-AIO-Key}}", "placement": "header" } }, "items": [ { "info": { "name": "Feeds", "type": "folder" }, "items": [ { "info": { "name": "All feeds for current user", "type": "http" }, "http": { "method": "GET", "url": "https://io.adafruit.com/api/v2/:username/feeds", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" } ] }, "docs": "The Feeds endpoint returns information about the user's feeds. The response includes the latest value of each feed, and other metadata about each feed." }, { "info": { "name": "Create a new Feed", "type": "http" }, "http": { "method": "POST", "url": "https://io.adafruit.com/api/v2/:username/feeds", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "group_key", "value": "", "type": "query" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a new Feed" }, { "info": { "name": "Get feed by feed key", "type": "http" }, "http": { "method": "GET", "url": "https://io.adafruit.com/api/v2/:username/feeds/:feed_key", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "path", "description": "a valid feed key" } ] }, "docs": "Returns feed based on the feed key" }, { "info": { "name": "Replace an existing Feed", "type": "http" }, "http": { "method": "PUT", "url": "https://io.adafruit.com/api/v2/:username/feeds/:feed_key", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "path", "description": "a valid feed key" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Replace an existing Feed" }, { "info": { "name": "Update properties of an existing Feed", "type": "http" }, "http": { "method": "PATCH", "url": "https://io.adafruit.com/api/v2/:username/feeds/:feed_key", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "path", "description": "a valid feed key" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update properties of an existing Feed" }, { "info": { "name": "Delete an existing Feed", "type": "http" }, "http": { "method": "DELETE", "url": "https://io.adafruit.com/api/v2/:username/feeds/:feed_key", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "path", "description": "a valid feed key" } ] }, "docs": "Delete an existing Feed" }, { "info": { "name": "Get detailed feed by feed key", "type": "http" }, "http": { "method": "GET", "url": "https://io.adafruit.com/api/v2/:username/feeds/:feed_key/details", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "path", "description": "a valid feed key" } ] }, "docs": "Returns more detailed feed record based on the feed key" }, { "info": { "name": "Add an existing Feed to a Group", "type": "http" }, "http": { "method": "POST", "url": "https://io.adafruit.com/api/v2/:username/groups/:group_key/add", "params": [ { "name": "group_key", "value": "", "type": "path" }, { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "query" } ] }, "docs": "Add an existing Feed to a Group" }, { "info": { "name": "Remove a Feed from a Group", "type": "http" }, "http": { "method": "POST", "url": "https://io.adafruit.com/api/v2/:username/groups/:group_key/remove", "params": [ { "name": "group_key", "value": "", "type": "path" }, { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "feed_key", "value": "", "type": "query" } ] }, "docs": "Remove a Feed from a Group" }, { "info": { "name": "All feeds for current user in a given group", "type": "http" }, "http": { "method": "GET", "url": "https://io.adafruit.com/api/v2/:username/groups/:group_key/feeds", "params": [ { "name": "group_key", "value": "", "type": "path" }, { "name": "username", "value": "", "type": "path", "description": "a valid username string" } ] }, "docs": "The Group Feeds endpoint returns information about the user's feeds. The response includes the latest value of each feed, and other metadata about each feed, but only for feeds within the given group." }, { "info": { "name": "Create a new Feed in a Group", "type": "http" }, "http": { "method": "POST", "url": "https://io.adafruit.com/api/v2/:username/groups/:group_key/feeds", "params": [ { "name": "username", "value": "", "type": "path", "description": "a valid username string" }, { "name": "group_key", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Create a new Feed in a Group" } ] } ], "bundled": true }