# Markaestro API

**Canonical:** https://apis.io/apis/markaestro-com/markaestro-com-api/  
**Provider:** Markaestro — https://apis.io/providers/markaestro-com/  
**Documentation:** https://markaestro.com/developers/api

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

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

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/oauth-protected-resource` | Markaestro for AI Agents |
| POST | `/api/connect/v1/media/create-upload-url` | Returns a short-lived, single-use signed PUT url plus a media id. |
| GET | `/api/connect/v1/posts` | Lists workspace posts with flat status, caption, and media urls. |
| POST | `/api/connect/v1/posts` | Creates a draft per selected account. |
| GET | `/api/connect/v1/products` | Lists brands (wire name: products) with their connected accounts nested, a brand-first picker. |
| GET | `/api/connect/v1/social-accounts` | Lists connected Facebook, Instagram, TikTok, and LinkedIn destinations as flat accounts, each labeled with its product so clients can group and disambiguate. |
| GET | `/api/public/v1/job-runs/{id}` | GET /api/public/v1/job-runs/:id Returns queued, running, succeeded, or failed. |
| POST | `/api/public/v1/mcp` | Markaestro for AI Agents |
| POST | `/api/public/v1/media` | Compatibility multipart upload. Returns an asset id and hosted URL. |
| POST | `/api/public/v1/media/upload-sessions` | Creates a 15‑minute direct upload session from fileName, contentType, and exact sizeBytes, reserving one media‑upload quota unit. |
| POST | `/api/public/v1/media/upload-sessions/{id}/finalize` | Verifies the stored type and size and returns the reusable media asset. |
| POST | `/api/public/v1/oauth/register` | Markaestro for AI Agents |
| POST | `/api/public/v1/oauth/revoke` | Markaestro for AI Agents |
| POST | `/api/public/v1/oauth/token` | Markaestro for AI Agents |
| GET | `/api/public/v1/posts` | Lists posts, newest first. Filter with ?status=scheduled to see what is queued, and ?productId= to scope to one brand. |
| POST | `/api/public/v1/posts` | Creates a draft in the workspace. |
| DELETE | `/api/public/v1/posts/{id}` | DELETE /api/public/v1/posts/:id Deletes the post from Markaestro. |
| GET | `/api/public/v1/posts/{id}` | GET /api/public/v1/posts/:id Returns current post status, delivery mode, and publish results. |
| GET | `/api/public/v1/posts/{id}/approval` | GET /api/public/v1/posts/:id/approval Read a submitted post’s review status, stage, and current version. |
| POST | `/api/public/v1/posts/{id}/approval` | POST /api/public/v1/posts/:id/approval Submit a draft, approve it, or request changes. |
| POST | `/api/public/v1/posts/{id}/publish` | POST /api/public/v1/posts/:id/publish Queues an async publish run. |
| GET | `/api/public/v1/products` | Lists the key's brands plus the channels currently available for each one. |
| GET | `/api/public/v1/products/{id}/destinations` | Lists the publish destinations for that brand, including standalone Instagram Login, Facebook Page, Threads, LinkedIn Profile/Page, and connected TikTok dest... |
| GET | `/api/public/v1/webhook-endpoints` | GET /api/public/v1/webhook-endpoints Lists registered webhook destinations for that API key scope. |
| POST | `/api/public/v1/webhook-endpoints` | POST /api/public/v1/webhook-endpoints Registers a webhook destination using an API key, up to 25 active endpoints per workspace. |
| DELETE | `/api/public/v1/webhook-endpoints/{id}` | DELETE /api/public/v1/webhook-endpoints/:id Disables a webhook destination. |
| POST | `/hooks/markaestro` | POST /hooks/markaestro |
| GET | `/llms.txt` | curl https://markaestro.com/llms.txt returns a plain-text brief of the whole API, endpoints, rules, and error handling. |
| GET | `/oauth/authorize` | Markaestro for AI Agents |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/markaestro-com/openapi/_ae-authored/markaestro-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/markaestro-com/json-schema/markaestro-com-post-api-public-v1-oauth-token-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/markaestro-com/json-schema/markaestro-com-post-api-public-v1-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/markaestro-com/json-schema/markaestro-com-post-api-public-v1-oauth-token-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/markaestro-com/json-schema/markaestro-com-post-api-connect-v1-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/markaestro-com/json-schema/markaestro-com-post-api-public-v1-media-upload-sessions-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/markaestro-com/json-schema/markaestro-com-post-api-connect-v1-media-create-upload-url-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/markaestro-com/apis.yml

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/markaestro-com` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

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