canonical: https://jentic.com/apis/padlet.dev/padlet

# Padlet API

Padlet is an online platform for collaboration and learning. The API allows you to manage boards, posts, comments, reactions, organizations, and users programmatically. Padlet boards serve as collaborative workspaces where teams can share ideas, files, and feedback. The API exposes operations for retrieving boards, adding posts with attachments, creating comments, managing reactions, generating AI-powered boards from recipes, and accessing user and organization information.

## For AI agents

Manage Padlet boards, posts, comments, reactions, AI recipe boards, organizations, and users programmatically.

## Scope

Manages boards, posts, comments, reactions, and AI recipe boards. Does not expose granular permission management, section manipulation, or webhook configuration - use the Padlet UI for those settings.

## Capabilities

- Retrieve board metadata including title, description, privacy settings, URL, and thumbnail
- Add posts to boards with body text, subject, attachments, and color styling
- Create comments on posts and retrieve post attachment data
- Add reactions to posts to provide feedback and engagement
- Generate AI-powered boards from recipes with status tracking
- Access current user information and organization details
- Retrieve user information within organizations

## Use cases

### Automated Content Publishing

Education platforms and content management systems can automatically publish learning materials, announcements, or updates to Padlet boards. POST `/boards/{board_id}/posts` creates a post with body text, subject, attachment URLs, and color options. This enables scheduled publishing, batch imports, or integration with content pipelines where materials are automatically posted to collaborative boards for teams or classrooms.

Example prompt: POST `/boards/{board_id}/posts` with body, subject, and attachment fields to publish content to a Padlet board.

### AI-Powered Board Generation

Applications can leverage Padlet's AI capabilities to generate boards from natural language recipes. POST /ai-recipe-boards initiates board creation and returns a status_key for tracking progress. GET `/ai-recipe-boards/status/{status_key}` polls the creation status until complete, returning the board_url. This enables conversational board creation, automated curriculum generation, or template-based board setup guided by AI.

Example prompt: POST /ai-recipe-boards with a recipe and optional title, then poll GET `/ai-recipe-boards/status/{status_key}` until the board is created and board_url is returned.

### Collaborative Feedback Collection

Team collaboration tools can integrate Padlet for collecting feedback via comments and reactions. POST `/posts/{post_hashid}/comments` adds comments to posts, and POST `/posts/{post_id}/reactions` registers reactions (e.g., likes). Combined with GET `/boards/{board_id}`, applications can display board content and aggregate feedback, enabling voting, sentiment analysis, or discussion threading for product feedback, brainstorming, or classroom participation.

Example prompt: GET `/boards/{board_id}` to retrieve the board and its posts, then POST `/posts/{post_id}/reactions` or POST `/posts/{post_hashid}/comments` to add reactions and comments.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/boards/{board_id}` | Retrieve a board by ID |
| POST | `/boards/{board_id}/posts` | Add a post to a board |
| POST | `/posts/{post_hashid}/comments` | Create a comment on a post |
| POST | `/posts/{post_id}/reactions` | Add a reaction to a post |
| POST | `/ai-recipe-boards` | Create an AI recipe board |
| GET | `/ai-recipe-boards/status/{status_key}` | Get AI board creation status |
| GET | `/me` | Get current user information |

## Key resources

- **Boards** — Retrieve board metadata including title, description, privacy, URL, and thumbnail
- **Posts** — Add posts to boards with body, subject, attachments, and color styling
- **Comments** — Create and manage comments on posts
- **Reactions** — Add reactions to posts for engagement and feedback
- **AI Recipe Boards** — Generate AI-powered boards from recipes with status tracking
- **Users** — Retrieve current user and organization user information
- **Organizations** — Access organization details by ID

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 68 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 57 / 100
  - AI-Readiness & Agent Experience: 54 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 80 / 100
- **View full report:** https://jentic.com/apis/padlet.dev/padlet/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Padlet by hand means handling its bearer-token auth against api.padlet.dev, shaping board, post, and comment payloads, and building your own retry and error handling. Through Jentic you install once, import the Padlet API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** Padlet puts the board id in the URL path (`/boards/{board_id}/posts`), so a rule can pin your agent to one board: it can add posts to that board and nothing else. You choose the operations it may call, so posting comments or reactions is not included unless you add them.
- **Credential handling:** Your Padlet token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'add a post to a Padlet board' or 'create an AI-generated board', and Jentic returns the matching Padlet operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Miro API** — Miro offers collaborative whiteboards with more advanced diagramming and brainstorming features.
- **Trello API** — Trello focuses on task management with kanban boards.

## FAQ

### What authentication does the Padlet API use?

The Padlet API uses bearer token authentication. Obtain an API token from your Padlet account settings and pass it in the Authorization header as 'Bearer <token>'. Through Jentic, tokens are stored encrypted and injected automatically at execution time.

### Can I generate boards with AI through the API?

Yes. POST /ai-recipe-boards with a recipe description initiates AI-powered board creation and returns a status_key. Poll GET `/ai-recipe-boards/status/{status_key}` to check progress. When complete, the response includes the board_url.

### How do I add posts with attachments?

Use POST `/boards/{board_id}/posts` with the body, subject, attachment (URL), and optional color fields. The attachment field accepts a URL to the file or resource you want to attach.

### Is the Padlet API free?

Padlet offers free and paid plans. API access and usage limits depend on your account tier. Check Padlet's pricing page for current plans and API access details.

### Can I retrieve attachment data for posts?

Yes. GET `/posts/{post_id}/attachmentData` returns the attachment URL, content type (MIME type), and original filename for a specific post.

### Can I limit what my agent is allowed to do with the Padlet API?

Yes. Because you run Jentic One yourself, your own rules decide which Padlet operations and credentials the agent may use. Since Padlet puts the board id in the URL path, such as POST `/boards/{board_id}/posts`, you can pin the agent to a single board so it only adds posts there and touches nothing else. You also choose the exact operations it may call, so creating comments via POST `/posts/{post_hashid}/comments` or adding reactions via POST `/posts/{post_id}/reactions` is available only if you grant it.