# ShapelessAI API

**Canonical:** https://apis.io/apis/shapelessai/shapelessai-api/  
**Provider:** ShapelessAI — https://apis.io/providers/shapelessai/  
**Documentation:** https://shapelessai.com/docs/api

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

ShapelessAI API as documented publicly: 37 operations. Contract generated from the documentation by API Evangelist (2026-10-12); not the provider's own document.

## Operations (37)

| Method | Path | Summary |
|---|---|---|
| DELETE | `/api/ads/campaigns` | Agents (strategies) and the manager |
| GET | `/api/ads/campaigns` | Agents (strategies) and the manager |
| POST | `/api/ads/campaigns` | Agents (strategies) and the manager |
| GET | `/api/brain/assets` | GET /api/brain/assets |
| POST | `/api/brain/{brainid}` | POST /api/brain/import write Import a .md/.txt/.pdf/.docx document. |
| POST | `/api/capabilities/{id}/want` | POST /api/capabilities/{id}/want any, or none with {email} / {webhookUrl} |
| DELETE | `/api/connections/link` | DELETE /api/connections/link write {platform} -> the one URL the human opens to connect an account there. |
| GET | `/api/connections/tracked` | GET /api/connections/tracked read |
| POST | `/api/connections/{id}` | POST /api/connections/{id} write |
| PATCH | `/api/connections/{id}/tiktok-creator-info` | PATCH /api/connections/{id}/tiktok-creator-info write |
| PATCH | `/api/groups/{id}` | Rename or recolor |
| PUT | `/api/manager/settings` | Agents (strategies) and the manager |
| GET | `/api/manager/{managerid}` | Agents (strategies) and the manager |
| POST | `/api/manager/{managerid}` | "Plan now" through the first active agent |
| GET | `/api/me/email` | Whether lifecycle email (posts ready, weekly summary) is on, and the last emails we sent. |
| PUT | `/api/me/email` | write |
| POST | `/api/metrics/refresh` | Refresh stale samples (calls the platforms). |
| GET | `/api/metrics/{metricid}` | GET /api/metrics/followers read Follower counts and the weekly delta. |
| GET | `/api/posts/{id}` | One row's live state. |
| POST | `/api/posts/{id}/comments/refresh` | Read the thread from the platform now. |
| POST | `/api/posts/{id}/{id}` | Propose a paid boost of a published Meta post. |
| POST | `/api/posts/{postid}` | Cap endpoint (no description provided) |
| GET | `/api/profile/audits` | Latest score and open fix count per connected account. |
| POST | `/api/strategies/suggest` | One engine‑studied agent seed for the editor |
| GET | `/api/studio/tail` | GET /api/studio/tail read Re-attach to a detached run's event log. |
| POST | `/api/studio/{studioid}` | POST /api/studio/stop write Stop a detached run. |
| GET | `/api/tools/{name}` | GET /api/tools/{name} write Run one tool. |
| GET | `/api/v1/jobs` | List jobs with liveness, one page (see Paging ). |
| POST | `/api/v1/jobs` | POST /api/v1/jobs write Start a job: {goal, label?, budgetUsd?, timezone?, attachments?, characters?} returns 202 {id, title, status}. |
| POST | `/api/videos/{videoid}` | demo_page : a recorded product demo of a page. |
| PUT | `/api/wiki/identity` | PUT /api/wiki/identity |
| DELETE | `/api/workspace/file` | PUT/DELETE /api/workspace/file write Write or delete one file. |
| GET | `/api/workspace/{workspaceid}` | GET /api/workspace/export read The whole brain as a zip. |
| DELETE | `/api/{apiid}` | DELETE /api/ad-accounts?id= publish Unlink an ad account. |
| GET | `/api/{apiid}` | GET /api/ad-accounts read Connected ad accounts (identity only, no tokens) + whether connecting one is configured. |
| PATCH | `/api/{apiid}` | Agents (strategies) and the manager |
| POST | `/api/{apiid}` | Send a drafted comment or reply, or run an approved boost or campaign change |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/openapi/_ae-authored/shapelessai-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/json-schema/shapelessai-post-api-v1-jobs-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/json-schema/shapelessai-post-api-posts-id-id-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/json-schema/shapelessai-get-api-posts-id-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/json-schema/shapelessai-put-api-me-email-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/json-schema/shapelessai-post-api-apiid-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/json-schema/shapelessai-post-api-v1-jobs-response-schema.json
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/shapelessai/refs/heads/main/apis.yml

---

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