Markaestro API

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

GitHub OpenAPI

Operations 29

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 destinations. #
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 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/markaestro-com:markaestro-com-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

markaestro-com-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Markaestro API
  version: '2026-11-17'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-17: 29 operation(s) read from 2 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Markaestro has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 1
    documentation: 28
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-17'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://markaestro.com/developers/api
  - https://markaestro.com/developers/agents
paths:
  /.well-known/oauth-protected-resource:
    get:
      operationId: get_well_known_oauth_protected_resource
      tags:
      - API
      summary: Markaestro for AI Agents
      x-source: https://markaestro.com/developers/agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/connect/v1/media/create-upload-url:
    post:
      operationId: post_api_connect_v1_media_create_upload_url
      tags:
      - Api
      summary: Returns a short-lived, single-use signed PUT url plus a media id.
      x-source: https://markaestro.com/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiConnectV1MediaCreateUploadUrlRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiConnectV1MediaCreateUploadUrlResponse'
      x-evidence:
        kind: documentation
  /api/connect/v1/posts:
    get:
      operationId: get_api_connect_v1_posts
      tags:
      - Api
      summary: Lists workspace posts with flat status, caption, and media urls.
      x-source: https://markaestro.com/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_connect_v1_posts
      tags:
      - Api
      summary: Creates a draft per selected account.
      x-source: https://markaestro.com/developers/api
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiConnectV1PostsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/connect/v1/products:
    get:
      operationId: get_api_connect_v1_products
      tags:
      - Api
      summary: 'Lists brands (wire name: products) with their connected accounts nested, a brand-first picker.'
      x-source: https://markaestro.com/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/connect/v1/social-accounts:
    get:
      operationId: get_api_connect_v1_social_accounts
      tags:
      - Api
      summary: Lists connected Facebook, Instagram, TikTok, and LinkedIn destinations as flat accounts, each labeled with its product so clients
        can group and disambiguate.
      x-source: https://markaestro.com/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/job-runs/{id}:
    get:
      operationId: get_api_public_v1_job_runs_id
      tags:
      - Api
      summary: GET /api/public/v1/job-runs/:id Returns queued, running, succeeded, or failed.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/mcp:
    post:
      operationId: post_api_public_v1_mcp
      tags:
      - Api
      summary: Markaestro for AI Agents
      x-source: https://markaestro.com/developers/agents
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/media:
    post:
      operationId: post_api_public_v1_media
      tags:
      - Api
      summary: Compatibility multipart upload. Returns an asset id and hosted URL.
      x-source: https://markaestro.com/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicV1MediaRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiPublicV1MediaResponse'
      x-evidence:
        kind: documentation
  /api/public/v1/media/upload-sessions:
    post:
      operationId: post_api_public_v1_media_upload_sessions
      tags:
      - Api
      summary: Creates a 15‑minute direct upload session from fileName, contentType, and exact sizeBytes, reserving one media‑upload quota unit.
      x-source: https://markaestro.com/developers/api
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicV1MediaUploadSessionsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiPublicV1MediaUploadSessionsResponse'
      x-evidence:
        kind: documentation
  /api/public/v1/media/upload-sessions/{id}/finalize:
    post:
      operationId: post_api_public_v1_media_upload_sessions_id_finalize
      tags:
      - Api
      summary: Verifies the stored type and size and returns the reusable media asset.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiPublicV1MediaUploadSessionsIdFinalizeResponse'
      x-evidence:
        kind: documentation
  /api/public/v1/oauth/register:
    post:
      operationId: post_api_public_v1_oauth_register
      tags:
      - Api
      summary: Markaestro for AI Agents
      x-source: https://markaestro.com/developers/agents
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicV1OauthRegisterRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/oauth/revoke:
    post:
      operationId: post_api_public_v1_oauth_revoke
      tags:
      - Api
      summary: Markaestro for AI Agents
      x-source: https://markaestro.com/developers/agents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicV1OauthRevokeRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/oauth/token:
    post:
      operationId: post_api_public_v1_oauth_token
      tags:
      - Api
      summary: Markaestro for AI Agents
      x-source: https://markaestro.com/developers/agents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicV1OauthTokenRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiPublicV1OauthTokenResponse'
      x-evidence:
        kind: documentation
  /api/public/v1/posts:
    get:
      operationId: get_api_public_v1_posts
      tags:
      - Api
      summary: Lists posts, newest first. Filter with ?status=scheduled to see what is queued, and ?productId= to scope to one brand.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
      - name: productId
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_public_v1_posts
      tags:
      - Api
      summary: Creates a draft in the workspace.
      x-source: https://markaestro.com/developers/api
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiPublicV1PostsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/posts/{id}:
    delete:
      operationId: delete_api_public_v1_posts_id
      tags:
      - Api
      summary: DELETE /api/public/v1/posts/:id Deletes the post from Markaestro.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    get:
      operationId: get_api_public_v1_posts_id
      tags:
      - Api
      summary: GET /api/public/v1/posts/:id Returns current post status, delivery mode, and publish results.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/posts/{id}/approval:
    get:
      operationId: get_api_public_v1_posts_id_approval
      tags:
      - Api
      summary: GET /api/public/v1/posts/:id/approval Read a submitted post’s review status, stage, and current version.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_public_v1_posts_id_approval
      tags:
      - Api
      summary: POST /api/public/v1/posts/:id/approval Submit a draft, approve it, or request changes.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/posts/{id}/publish:
    post:
      operationId: post_api_public_v1_posts_id_publish
      tags:
      - Api
      summary: POST /api/public/v1/posts/:id/publish Queues an async publish run.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/products:
    get:
      operationId: get_api_public_v1_products
      tags:
      - Api
      summary: Lists the key's brands plus the channels currently available for each one.
      x-source: https://markaestro.com/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/products/{id}/destinations:
    get:
      operationId: get_api_public_v1_products_id_destinations
      tags:
      - Api
      summary: Lists the publish destinations for that brand, including standalone Instagram Login, Facebook Page, Threads, LinkedIn Profile/Page,
        and connected TikTok destinations.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/webhook-endpoints:
    get:
      operationId: get_api_public_v1_webhook_endpoints
      tags:
      - Api
      summary: GET /api/public/v1/webhook-endpoints Lists registered webhook destinations for that API key scope.
      x-source: https://markaestro.com/developers/api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_public_v1_webhook_endpoints
      tags:
      - Api
      summary: POST /api/public/v1/webhook-endpoints Registers a webhook destination using an API key, up to 25 active endpoints per workspace.
      x-source: https://markaestro.com/developers/api
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/public/v1/webhook-endpoints/{id}:
    delete:
      operationId: delete_api_public_v1_webhook_endpoints_id
      tags:
      - Api
      summary: DELETE /api/public/v1/webhook-endpoints/:id Disables a webhook destination.
      x-source: https://markaestro.com/developers/api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /hooks/markaestro:
    post:
      operationId: post_hooks_markaestro
      tags:
      - Hooks
      summary: POST /hooks/markaestro
      x-source: https://markaestro.com/developers/agents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostHooksMarkaestroRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST \"$MARKAESTRO_URL/api/public/v1/webhook-endpoints\"  -H \"Authorization: Bearer $MARKAESTRO_API_KEY\"  -H \"Content-Type:\
          \ application/json\"  -d '{\n \"url\": \"https://your-agent.example.com/hooks/markaestro\",\n \"events\": [\"post.published\", \"post.action_required\"\
          , \"post.failed\"]\n }'"
  /llms.txt:
    get:
      operationId: get_llms_txt
      tags:
      - Llms
      summary: curl https://markaestro.com/llms.txt returns a plain-text brief of the whole API, endpoints, rules, and error handling.
      x-source: https://markaestro.com/developers/agents
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetLlmsTxtResponse'
      x-evidence:
        kind: documentation
  /oauth/authorize:
    get:
      operationId: get_oauth_authorize
      tags:
      - Oauth
      summary: Markaestro for AI Agents
      x-source: https://markaestro.com/developers/agents
      parameters:
      - name: response_type
        in: query
        required: true
        schema:
          type: string
      - name: client_id
        in: query
        required: true
        schema:
          type: string
      - name: redirect_uri
        in: query
        required: true
        schema:
          type: string
      - name: code_challenge
        in: query
        required: true
        schema:
          type: string
      - name: code_challenge_method
        in: query
        required: true
        schema:
          type: string
      - name: state
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiConnectV1MediaCreateUploadUrlRequest:
      type: object
      properties:
        mime_type:
          type: string
        size_bytes:
          type: string
        name:
          type: string
      required:
      - mime_type
      - size_bytes
      - name
    PostApiConnectV1MediaCreateUploadUrlResponse:
      type: object
      properties:
        upload_url:
          type: string
        media_id:
          type: string
    PostApiConnectV1PostsRequest:
      type: object
      properties:
        caption:
          type: string
        media:
          type: string
        social_accounts:
          type: string
        is_draft:
          type: string
        scheduled_at:
          type: string
    PostApiPublicV1MediaRequest:
      type: object
      properties:
        file:
          type: string
      required:
      - file
    PostApiPublicV1MediaResponse:
      type: object
      properties:
        assetId:
          type: string
        url:
          type: string
    PostApiPublicV1MediaUploadSessionsRequest:
      type: object
      properties:
        fileName:
          type: string
        contentType:
          type: string
        sizeBytes:
          type: string
      required:
      - fileName
      - contentType
      - sizeBytes
    PostApiPublicV1MediaUploadSessionsResponse:
      type: object
      properties:
        uploadUrl:
          type: string
        sessionId:
          type: string
    PostApiPublicV1MediaUploadSessionsIdFinalizeResponse:
      type: object
      properties:
        asset.id:
          type: string
        asset.url:
          type: string
    PostApiPublicV1OauthRegisterRequest:
      type: object
      properties:
        name:
          type: string
          description: Client name
        redirect_uri:
          type: string
          description: Callback address
    PostApiPublicV1OauthRevokeRequest:
      type: object
      properties:
        token:
          type: string
          description: Token to revoke
      required:
      - token
    PostApiPublicV1OauthTokenRequest:
      type: object
      properties:
        grant_type:
          type: string
          description: authorization_code or refresh_token
        code:
          type: string
          description: Authorization code
        code_verifier:
          type: string
          description: PKCE verifier
        refresh_token:
          type: string
          description: Refresh token
      required:
      - grant_type
    PostApiPublicV1OauthTokenResponse:
      type: object
      properties:
        access_token:
          type: string
        token_type:
          type: string
        expires_in:
          type: integer
        refresh_token:
          type: string
        scope:
          type: string
    PostApiPublicV1PostsRequest:
      type: object
      properties:
        channel:
          type: string
        caption:
          type: string
        mediaAssetIds:
          type: string
        productId:
          type: string
        destinationId:
          type: string
        deliveryMode:
          type: string
    PostHooksMarkaestroRequest:
      type: object
      properties:
        url:
          type: string
        events:
          type: array
          items:
            type: string
    GetLlmsTxtResponse:
      type: object
      properties:
        body:
          type: string
          description: Plain‑text brief of the API
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: API
- name: Api
- name: Hooks
- name: Llms
- name: Oauth