list_post_media

List post media

List attachment metadata; binary content is not embedded.

Authorization and permissions

Requires a valid delegated OAuth token and access to the selected workspace.

OAuth scope: mcp:read
Workspace requirement: Authorized workspace and current membership required

Current workspace member.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "post_id": {
      "description": "Public post sqid.",
      "maxLength": 32,
      "minLength": 1,
      "type": "string"
    },
    "team_id": {
      "description": "Consented workspace ID.",
      "minimum": 1,
      "type": "integer"
    }
  },
  "required": [
    "team_id",
    "post_id"
  ],
  "type": "object"
}

Result schema

{
  "additionalProperties": false,
  "properties": {
    "media": {
      "description": "Media.",
      "items": {
        "additionalProperties": false,
        "description": "Media item.",
        "properties": {
          "filename": {
            "description": "Filename.",
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "description": "Id.",
            "minimum": 1,
            "type": "integer"
          },
          "order": {
            "description": "Order.",
            "type": "integer"
          },
          "pages": {
            "description": "Pages.",
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "size": {
            "description": "Size.",
            "minimum": 0,
            "type": [
              "integer",
              "null"
            ]
          },
          "title": {
            "description": "Title.",
            "type": [
              "string",
              "null"
            ]
          },
          "type": {
            "description": "Type.",
            "type": "string"
          }
        },
        "required": [
          "id",
          "type",
          "filename",
          "title",
          "size",
          "pages",
          "order"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "media"
  ],
  "type": "object"
}

Example arguments

{
  "post_id": "P7k2Lm9Q",
  "team_id": 42
}

Example result

{
  "media": [
    {
      "filename": "onboarding-checklist.pdf",
      "id": 615,
      "order": 0,
      "pages": 8,
      "size": 842311,
      "title": "The Customer Onboarding Checklist",
      "type": "document"
    }
  ]
}

Errors and retry

Requires current workspace membership. Unknown posts, media, accounts, and cross-workspace IDs return not found. Upload commit, rename, and delete recheck edit permission, approval confirmation, and the post version; invalid type, size, or title is rejected. Calls are limited to 120 per user per minute.

Metadata reads and transfer-instruction requests are safe to retry, but transfer URLs still require the delegated bearer credential (the example is an instruction, not a token). After an ambiguous upload or mutation, list media and reload the post version before retrying; delete is not safe to repeat after success.

Effects, limits, and source

Workspace roles, subscription and AI usage limits, approval rules, and server rate limits are enforced at call time. Rate-limit responses identify when to retry; scheduled work returns state rather than holding the request open.

social_scheduling.api.media_list