mellow-world API

openapi: 3.1.0
info:
  title: mellow-world API
  version: '2026-10-31'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-31: 6 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; mellow-world has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 4
    pages-with-code: 1
    pages-read: 2
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-31'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://www.mellow.world/hub/guides/schedule-posts-api
  - https://www.mellow.world/hub/answers/n8n-social-media-automation
paths:
  /api/hub/v1/channels:
    get:
      operationId: get_api_hub_v1_channels
      tags:
      - Api
      summary: GET /api/hub/v1/channels
      x-source: https://www.mellow.world/hub/guides/schedule-posts-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl --fail-with-body https://www.mellow.world/api/hub/v1/channels  -H "Authorization: Bearer $MELLOW_HUB_KEY" Use the channel
          IDs returned for this account. The spc_… values below are placeholders. Check the mode and available allowance before creating anything.
          A review credential prepares a post for a person to approve. An autopilot credential can act within its delegated scope, ceiling and
          exp'
  /api/hub/v1/posts:
    post:
      operationId: post_api_hub_v1_posts
      tags:
      - Api
      summary: Create (publish) a post.
      description: POST /api/hub/v1/posts creates the post with the same body as validate and returns the created post. Re‑using the same Idempotency-Key
        returns the original post; a different payload under the same key yields an idempotency_key_reused error.
      x-source: https://www.mellow.world/hub/answers/n8n-social-media-automation
      parameters:
      - name: Idempotency-Key
        in: header
        required: true
        schema:
          type: string
        description: 8‑120 characters of letters, digits, _, :, -, and ,; used to deduplicate requests.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiHubV1PostsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiHubV1PostsResponse'
      x-evidence:
        kind: documentation
  /api/hub/v1/posts/{id}:
    get:
      operationId: get_api_hub_v1_posts_id
      tags:
      - Api
      summary: Schedule social media posts with a REST API
      x-source: https://www.mellow.world/hub/guides/schedule-posts-api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/hub/v1/posts/{id}/retry:
    post:
      operationId: post_api_hub_v1_posts_id_retry
      tags:
      - Api
      summary: Schedule social media posts with a REST API
      x-source: https://www.mellow.world/hub/guides/schedule-posts-api
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/hub/v1/validate:
    post:
      operationId: post_api_hub_v1_validate
      tags:
      - Api
      summary: Validate a post without publishing.
      description: POST /api/hub/v1/validate with the post body publishes nothing and returns ok, issues and notes. It always returns HTTP 200,
        even when ok is false.
      x-source: https://www.mellow.world/hub/answers/n8n-social-media-automation
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiHubV1ValidateRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiHubV1ValidateResponse'
      x-evidence:
        kind: documentation
  /api/hub/v1/whoami:
    get:
      operationId: get_api_hub_v1_whoami
      tags:
      - Api
      summary: GET /api/hub/v1/whoami
      x-source: https://www.mellow.world/hub/guides/schedule-posts-api
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl requests below, save your edited file as post.json . 1. Check the account and credential Connect your own channels in Hub
          and create a credential with the channels and mode you intend to delegate. Store it in your server’s secret environment as MELLOW_HUB_KEY
          ; never put it in frontend JavaScript or a public repository. The examples read that environment variable without displaying its value.
components:
  schemas:
    PostApiHubV1PostsRequest:
      type: object
      properties:
        caption:
          type: string
          description: Post caption.
        channels:
          type: array
          description: List of channel IDs to publish to.
        media:
          type: array
          description: Public URLs of media to attach.
        scheduledAt:
          type: string
          description: ISO‑8601 timestamp for scheduled publishing.
        perChannel:
          type: object
          description: Optional per‑channel overrides such as a custom caption.
      required:
      - channels
    PostApiHubV1PostsResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the created post.
        status:
          type: object
          description: Per‑network status and links.
    PostApiHubV1ValidateRequest:
      type: object
      properties:
        caption:
          type: string
          description: Post caption.
        channels:
          type: array
          description: List of channel IDs (e.g., spc_instagram_example).
        media:
          type: array
          description: Public URLs of media to attach.
        scheduledAt:
          type: string
          description: ISO‑8601 timestamp for scheduled publishing.
        perChannel:
          type: object
          description: Optional per‑channel overrides such as a custom caption.
      required:
      - channels
    PostApiHubV1ValidateResponse:
      type: object
      properties:
        ok:
          type: boolean
          description: True if the post passes validation.
        issues:
          type: array
          description: List of validation issues, if any.
        notes:
          type: array
          description: Additional notes from the validation.
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api