Add a board item

Pin an App Store app, or save one paid ad, to a board.

Last reviewed September 21, 2026Download Markdown ↓

POSThttps://api.peekpanda.com/v1/boards/{boardId}/items

Request

Repeating the same app or ad returns the existing item. Pinning never watches the app or starts collection. At most 500 items per board.

Parameters

NameInTypeRequiredDescription

boardIdpathuuidYesBoard id.

kindbody'app' | 'ad'YesWhat to add.

storeIdbodystringYesFor an app: numeric App Store id of a catalogue app.

platformbody'meta' | 'tiktok'YesFor an ad: advertising platform.

archiveIdbodystringYesFor an ad: archive id.

notebodystring | nullYesOptional note, up to 500 characters.

Response

The board item. An app item carries its stored evidence and the caller's watchlist stamps.

Response fields

idstring

kindstring

storeIdstring

namestring

iconUrlnull

notenull

addedByUserIdstring

createdAtstring

watchnull

evidence.liveAdsnumber

evidence.newAdsThisWeeknumber

evidence.savedAdsOnBoardnumber

evidence.inCatalogueboolean

Authentication

Requires Bearer API credential or OAuth access token. Scope content:write. MCP calls manage_boards with action add_item.

Errors

400invalid_request for an invalid filter, identity or limit.

401authentication_required for a missing or invalid credential.

402subscription_required when access is not entitled.

403authorization_required for a missing scope or unavailable preview access.

403workspace_not_accessible when x-genviral-tenancy names a workspace the credential cannot reach.

404not_found when the record is outside the accessible catalogue.

429rate_limited; honor Retry-After when present.

409conflict when the write would duplicate an exclusive row.

MCP request

Call manage_boards with action add_item. Path fields go in params, filters in query, and a write body in body.

{
  "name": "manage_boards",
  "arguments": {
    "request": {
      "action": "add_item",
      "params": {
        "boardId": "<boardId>"
      }
    }
  }
}

Source

Boards are the caller's own organization, stored in PeekPanda. Pinned apps carry the listing name and icon as pinned; evidence counts are stored paid-ad observations.

Refresh

Board reads and writes never call a provider or start collection. Pinning an app does not watch it; watching stays on the ASO tracked-app list.

AI agent or LLM? Read this page as markdown