> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnimux.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Public hosts only: console https://omnimux.ai/dashboard · API https://api.omnimux.ai · docs https://docs.omnimux.ai.
> Gateway auth is Authorization: Bearer sk-… on https://api.omnimux.ai/v1 (OpenAI-compatible Chat Completions and related paths).
> Discover pages from /llms.txt; full site dump /llms-full.txt; product skill /skill.md; docs search MCP /mcp. Prefer .md page URLs for Markdown.
> Default docs locale is en; zh mirrors the same relative paths. Do not invent model ids not present on live pricing or the complete API pages.

# Get Post

> Get Post — explicit account source

Checks the stored post provider even when refresh=0. Cross-source tasks return 409 and are not returned or refreshed. Status is the gateway's stored or refreshed value, not a guarantee of publication.

`provider` is required: `tiktok_direct` or `zernio`. It constrains the operation and never rewrites the stored source. Missing or unknown values return 400 `invalid-provider`.

Use an OmniMux user access token and `New-Api-User`, not an `sk-` key. Inspect `success` as well as HTTP status; some upstream failures return HTTP 200 with `success:false`.


## OpenAPI

````yaml openapi/ops/publishing/get-post.json GET /api/social/v1/posts/{id}
openapi: 3.1.0
info:
  title: OmniMux Publishing — Get Post
  version: provider-isolation
servers:
  - url: https://omnimux.ai
security:
  - accessToken: []
    userId: []
paths:
  /api/social/v1/posts/{id}:
    get:
      summary: Get Post
      operationId: getPost
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: integer
            format: int64
            minimum: 1
          description: OmniMux local record ID, not the upstream provider ID.
        - name: provider
          in: query
          required: true
          schema:
            type: string
            enum:
              - tiktok_direct
              - zernio
            description: >-
              Required expected source; never changes the stored account or post
              provider.
          example: zernio
        - name: refresh
          in: query
          required: false
          schema:
            type: string
            enum:
              - '0'
              - '1'
            default: '1'
          description: >-
            0 reads stored state; 1 refreshes upstream after ownership and
            provider checks.
      responses:
        '200':
          description: >-
            Check success before reading data. Generic upstream errors may use
            HTTP 200 with success:false.
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      success:
                        type: boolean
                        enum:
                          - true
                      data:
                        type: object
                        properties:
                          id:
                            type: integer
                            format: int64
                          provider:
                            type: string
                            enum:
                              - tiktok_direct
                              - zernio
                            description: >-
                              Required expected source; never changes the stored
                              account or post provider.
                            example: zernio
                          status:
                            type: string
                          provider_post_id:
                            type: string
                          content_preview:
                            type: string
                          created_at:
                            type: integer
                            format: int64
                          updated_at:
                            type: integer
                            format: int64
                          result: {}
                        required:
                          - id
                          - provider
                          - status
                    required:
                      - success
                      - data
                  - type: object
                    properties:
                      success:
                        type: boolean
                        enum:
                          - false
                      message:
                        type: string
                      code:
                        type: string
                    required:
                      - success
                      - message
        '400':
          description: >-
            Missing/unknown provider or invalid request. invalid-provider
            identifies a missing or unknown source.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '402':
          description: >-
            Billing-related rejection where applicable; upstream failures may
            instead be wrapped as success:false.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '403':
          description: Account ownership or access denied.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '404':
          description: Account or post not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
        '409':
          description: Account, post or idempotency source/account-set mismatch.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
              example:
                success: false
                code: post-provider-mismatch
                message: post-provider-mismatch
        '503':
          description: Requested provider is disabled or not configured.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  message:
                    type: string
                  code:
                    type: string
                required:
                  - success
                  - message
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request GET \
              --url "https://omnimux.ai/api/social/v1/posts/<record-id>?provider=zernio&refresh=0" \
              --header 'Authorization: Bearer <user-access-token>' \
              --header 'New-Api-User: <user-id>'
components:
  securitySchemes:
    accessToken:
      type: http
      scheme: bearer
      description: OmniMux user access token, not an sk- API key.
    userId:
      type: apiKey
      in: header
      name: New-Api-User
      description: Current authenticated user ID.

````