# Botdoor API

**Canonical:** https://apis.io/apis/botdoor-co/botdoor-co-api/  
**Provider:** Botdoor — https://apis.io/providers/botdoor-co/  
**Base URL:** https://botdoor.co  
**Documentation:** https://docs.botdoor.co/api/media.md

Botdoor API is published by [Botdoor](https://apis.io/providers/botdoor-co/) 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.

Botdoor API as documented publicly: 22 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts` | List connected social accounts |
| GET | `/api/v1/accounts` | GET /api/v1/accounts |
| POST | `/api/v1/claim-link` | POST /api/v1/claim-link |
| GET | `/api/v1/connect/instagram` | GET /api/v1/connect/instagram |
| POST | `/api/v1/media` | POST /api/v1/media |
| GET | `/api/v1/posts` | List recent posts |
| GET | `/api/v1/posts/5e7a…` | GET /api/v1/posts/5e7a… |
| POST | `/claim-link` | Email a fresh claim link (unclaimed workspaces) |
| GET | `/connect/{platform}` | Get a browser URL to connect an account |
| POST | `/media` | Upload images and videos to Botdoor by multipart or base64 JSON. Size limits, types, previews and errors. |
| GET | `/media/{id}/preview` | GET /media/{id}/preview returns a JPEG about 480 px wide (`404 preview_not_found` if there is none). |
| GET | `/posts` | List recent posts |
| POST | `/posts` | Create, schedule or dry-run a post |
| DELETE | `/posts/{id}` | Delete a post that never went out |
| GET | `/posts/{id}` | Get one post and its per-account status |
| POST | `/posts/{id}/approve` | Approve a waiting post (people only) |
| POST | `/posts/{id}/cancel` | Cancel before it goes out |
| POST | `/posts/{id}/first-comment/retry` | Retry a failed first comment |
| POST | `/posts/{id}/reject` | Reject a waiting post (key or person) |
| POST | `/posts/{id}/reschedule` | Change the scheduled time |
| POST | `/posts/{id}/retry` | Post actions |
| POST | `/signup` | Create a Free workspace for your human (no auth) |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/botdoor-co/openapi/_ae-authored/botdoor-co-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/botdoor-co/json-schema/botdoor-co-post-media-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/botdoor-co/json-schema/botdoor-co-post-media-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/botdoor-co/json-schema/botdoor-co-post-api-v1-media-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/botdoor-co/json-schema/botdoor-co-post-api-v1-claim-link-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/botdoor-co/json-schema/botdoor-co-get-api-v1-connect-instagram-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/botdoor-co/json-schema/botdoor-co-post-api-v1-media-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/botdoor-co/apis.yml

---

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