> ## Documentation Index > Fetch the complete documentation index at: https://docs.adside.ai/llms.txt > Use this file to discover all available pages before exploring further. # List > List the posts Adside published, or tried to publish, on this workspace's own social accounts, newest first: platform, state, the post's link, who asked, and why one failed CLI: `adside publications list` ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/workspaces/{workspaceId}/publications openapi: 3.1.0 info: title: Adside API version: 1.0.0 description: >- Campaigns, creatives, assets and reporting across your ad accounts. Call it with a personal API key as a bearer token, or with the `adside` CLI: each page names its command. servers: - url: https://api.adside.ai description: Production security: - userAccess: [] tags: - name: Account - name: Reporting - name: Meta - name: Google Ads - name: LinkedIn - name: TikTok - name: Reddit - name: Snapchat - name: X - name: Google Tag Manager - name: Creatives - name: Creative styles - name: Media - name: Characters - name: Assets - name: Brands - name: Brain - name: Research - name: Boards - name: Artifacts - name: Audiences - name: Ad comments - name: Publications - name: Routines - name: Skills - name: To-dos - name: Audit - name: Credits paths: /v1/workspaces/{workspaceId}/publications: get: tags: - Publications summary: List description: >- List the posts Adside published, or tried to publish, on this workspace's own social accounts, newest first: platform, state, the post's link, who asked, and why one failed CLI: `adside publications list` operationId: publications.list parameters: - name: workspaceId in: path required: true schema: type: string minLength: 1 - name: platform in: query required: false description: Only this platform's publications. schema: description: Only this platform's publications. type: string enum: - instagram - tiktok - x - youtube style: form explode: true - name: state in: query required: false description: Only publications in this state. schema: description: Only publications in this state. type: string enum: - processing - published - scheduled - sent_to_inbox - failed - unknown - deleted style: form explode: true - name: since in: query required: false description: >- Only publications asked for at or after this time, as an ISO 8601 date and time with its offset, e.g. 2026-11-01T00:00:00Z. schema: description: >- Only publications asked for at or after this time, as an ISO 8601 date and time with its offset, e.g. 2026-11-01T00:00:00Z. type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ style: form explode: true - name: cursor in: query required: false schema: type: string maxLength: 300 style: form explode: true - name: limit in: query required: false description: How many publications to return. schema: default: 25 description: How many publications to return. type: integer minimum: 1 maximum: 100 style: form explode: true responses: '200': description: Success content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object properties: publications: type: array items: type: object properties: id: type: string platform: type: string enum: - instagram - tiktok - x - youtube state: type: string enum: - processing - published - scheduled - sent_to_inbox - failed - unknown - deleted phase: anyOf: - type: string - type: 'null' format: type: string account: type: object properties: id: type: string handle: type: string pageId: anyOf: - type: string - type: 'null' required: - id - handle - pageId additionalProperties: false postId: anyOf: - type: string - type: 'null' permalink: anyOf: - type: string - type: 'null' initiatedBy: type: object properties: id: type: string name: anyOf: - type: string - type: 'null' required: - id - name additionalProperties: false principalKind: type: string failure: anyOf: - type: object properties: code: anyOf: - type: string - type: 'null' message: type: string required: - code - message additionalProperties: false - type: 'null' notices: type: array items: type: object properties: code: type: string message: type: string required: - code - message additionalProperties: false media: type: array items: type: object properties: role: type: string enum: - item - cover position: type: integer minimum: -9007199254740991 maximum: 9007199254740991 assetId: anyOf: - type: string - type: 'null' preparedAssetId: anyOf: - type: string - type: 'null' platformMediaId: anyOf: - type: string - type: 'null' required: - role - position - assetId - preparedAssetId - platformMediaId additionalProperties: false createdAt: type: string publishedAt: anyOf: - type: string - type: 'null' completedAt: anyOf: - type: string - type: 'null' deletedAt: anyOf: - type: string - type: 'null' required: - id - platform - state - phase - format - account - postId - permalink - initiatedBy - principalKind - failure - notices - media - createdAt - publishedAt - completedAt - deletedAt additionalProperties: false nextCursor: anyOf: - type: string - type: 'null' required: - publications - nextCursor additionalProperties: false security: - userAccess: [] components: securitySchemes: userAccess: type: http scheme: bearer description: >- A personal API key (`adside_pat_…`) or a token from `adside login`. Either carries the permissions of the person it belongs to. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.