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

# List Accounts

> List Accounts — explicit account source

Only returns the selected source. The official list does not create a Zernio tenant or run a Zernio sync. An empty array means success with no accounts; failed responses are not empty lists.

`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`.

CLI 0.4.0: run `omnimux update` (binary) or `npm install -g @omnimux/cli@0.4.0` (npm), then use `omnimux social accounts --provider zernio` or `--provider tiktok_direct`. Update saved scripts as well. See [API Updates](/en/updates#2026-09-07-social-provider-required).


## OpenAPI

````yaml openapi/ops/publishing/list-accounts.json GET /api/social/v1/accounts
openapi: 3.1.0
info:
  title: OmniMux Publishing — List Accounts
  version: provider-isolation
servers:
  - url: https://omnimux.ai
security:
  - accessToken: []
    userId: []
paths:
  /api/social/v1/accounts:
    get:
      summary: List Accounts
      operationId: listAccounts
      parameters:
        - 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
      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:
                          accounts:
                            type: array
                            items:
                              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
                                platform:
                                  type: string
                                username:
                                  type: string
                                display_name:
                                  type: string
                                status:
                                  type: string
                              required:
                                - id
                                - provider
                                - platform
                                - status
                        required:
                          - accounts
                    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
        '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/accounts?provider=zernio" \
              --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.

````