# pnut.io API

**Canonical:** https://apis.io/apis/pnut/pnut-api/  
**Provider:** pnut.io — https://apis.io/providers/pnut/  
**Base URL:** https://api.pnut.io  
**Documentation:** https://pnut.io/docs/resources/clients

pnut.io API is one of 2 APIs that [pnut.io](https://apis.io/providers/pnut/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

pnut.io API as documented publicly: 201 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (60 of 201)

| Method | Path | Summary |
|---|---|---|
| GET | `/apps/me/users/ids` | Retrieve a list of all user IDs that authorize the requesting app. |
| GET | `/apps/me/users/tokens` | Retrieve a list of all user token objects that authorize the requesting app. |
| GET | `/badges` | Retrieve a list of all badges. |
| GET | `/badges/{badgeId}` | Retrieve a badge object. |
| GET | `/channels` | Retrieve a list of specified channel objects. |
| GET | `/channels/streams/explore` | Retrieve a list of explore streams. |
| GET | `/channels/streams/explore/{slug}` | Retrieve a list of channels in an explore stream. |
| GET | `/channels/{channelId}` | Retrieve a channel by its ID. |
| GET | `/channels/{channelId}/messages` | Retrieve paginated messages from a channel. |
| GET | `/channels/{channelId}/messages/{messageId}` | Retrieve a message from a channel. |
| POST | `/channels/{channelId}/messages/{messageId}/report` | Report a message in a channel for abuse. |
| DELETE | `/channels/{channelId}/messages/{messageId}/sticky` | Un-sticky a message. |
| PUT | `/channels/{channelId}/messages/{messageId}/sticky` | Sticky a message. |
| GET | `/channels/{channelId}/messages/{messageId}/thread` | Retrieve messages in the same thread of a channel. |
| DELETE | `/channels/{channelId}/mute` | Delete a subscription mute for a channel. |
| PUT | `/channels/{channelId}/mute` | Mute subscriptions for a channel. |
| GET | `/channels/{channelId}/sticky_messages` | Retrieve sticky messages in a channel. |
| GET | `/clients/{clientId}` | Retrieve details on a public client, by client ID. |
| GET | `/feed/rss/channels/search` | Channel search results are exposed as RSS. |
| GET | `/feed/rss/channels/{channelId}/messages` | Messages are exposed as RSS. |
| GET | `/feed/rss/posts/search` | Post search results are exposed as RSS. |
| GET | `/feed/rss/posts/tags/{tag}` | The API exposes tagged posts as RSS. |
| GET | `/feed/rss/users/{userId}/posts` | A user's posts are exposed as RSS. |
| DELETE | `/files` | Delete a list of files. |
| GET | `/files` | Retrieve a list of specified file objects. |
| POST | `/files/provision` | Prime the upload server for files to be uploaded. |
| GET | `/files/{fileId}` | Retrieve a file object by ID. |
| PATCH | `/files/{fileId}` | Update a file's details. |
| POST | `/markers` | Set a list of stream markers |
| GET | `/polls` | Retrieve a list of specified poll objects. |
| POST | `/polls` | Create a poll. |
| DELETE | `/polls/{pollId}` | Delete a poll. |
| GET | `/polls/{pollId}` | Retrieve a poll object. |
| PUT | `/polls/{pollId}/response` | Respond to a poll. |
| GET | `/posts` | Retrieve a list of specified post objects. |
| POST | `/posts` | Create a post. |
| GET | `/posts/streams/explore` | Retrieve a list of explore streams. |
| GET | `/posts/streams/explore/{slug}` | Retrieve a list of posts in an explore stream. |
| GET | `/posts/streams/global` | A stream of all human-type users' public posts. |
| GET | `/posts/streams/me` | The authenticated user's stream of posts from their followers and themself. |
| GET | `/posts/streams/unified` | A combined Personal Stream including the authenticated user's mentions. |
| GET | `/posts/tags/{tag}` | A stream of all posts that include the specified tag. |
| DELETE | `/posts/{postId}` | Delete a post. |
| GET | `/posts/{postId}` | Retrieve a post object. |
| PUT | `/posts/{postId}` | Edit or "revise" a post. |
| DELETE | `/posts/{postId}/bookmark` | Delete a bookmark. |
| PUT | `/posts/{postId}/bookmark` | Bookmark a post. |
| POST | `/posts/{postId}/report` | Report a post for abuse. |
| DELETE | `/posts/{postId}/repost` | Delete a repost. |
| PUT | `/posts/{postId}/repost` | Repost another post. |
| GET | `/posts/{postId}/revisions` | Retrieve a list of previous versions of a post, not including the most recent. |
| GET | `/posts/{postId}/thread` | Retrieve posts within a thread. |
| DELETE | `/streams` | Delete all app streams for the authorized app. |
| GET | `/streams` | Get all app streams for the authenticated app. |
| POST | `/streams` | Create an app stream for the authenticated app. |
| DELETE | `/streams/{streamKey}` | Delete a specific app stream by its key. |
| GET | `/streams/{streamKey}` | Get a specific app stream by its key. |
| PUT | `/streams/{streamKey}` | Update an app stream. |
| GET | `/sys/config` | Retrieve a list of parameters for interacting with the API. |
| GET | `/sys/ops/{opsId}` | Retrieve the status of a long-running operation. |

…and 141 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/pnut/openapi/_ae-authored/pnut-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/pnut/json-schema/pnut-post-polls-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/pnut/json-schema/pnut-get-files-fileid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/pnut/json-schema/pnut-post-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/pnut/json-schema/pnut-get-channels-channelid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/pnut/json-schema/pnut-get-sys-ops-opsid-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/pnut/json-schema/pnut-put-posts-postid-request-schema.json

## Other pnut.io APIs (1)

- [Pnut API](https://apis.io/apis/pnut/pnut-api-2/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/pnut/pnut-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/pnut/.