Posts

Find posts by date, status, platform or words

Posts newest first, like the calendar: from/to pick by when a post goes out or went out; status, platforms, channel_ids, customer_id and query narrow them.

GEThttps://traceeai.com/api/v1/calendar

CLI:tracee posts search·MCP:postsaction list

Authorizations

  • Authorizationstringheaderrequired

    Bearer <key>: a personal key (tracee login or Settings → Personal keys), a workspace key, or an MCP client's OAuth token. See Authentication.

Headers

  • Tracee-Workspacestring

    For a personal key or OAuth token that reaches several workspaces: the workspace id to act on. Workspace keys don't need it.

    uuid

Query parameters

Lists: comma-separated or repeated
  • fromstring

    From this date or time

    up to 40 characters

  • tostring

    Up to this date (inclusive) or time

    up to 40 characters

  • statusstring[]

    Only these statuses

    up to 9 items

    Available options:draftpending_approvalapprovedrejectedscheduledpublishedpartially_publishedfailedremoved

  • platformsstring[]

    Only posts with a variant on these networks, e.g. ["linkedin", "x"]

    up to 40 itemseach up to 30 characters

  • channel_idsstring[]

    each uuid

  • customer_idstring

    Only posts on this client's channels. From GET /api/v1/customers

    uuid

  • querystring

    Words in the title or copy

    up to 200 characters

  • limitinteger

    The limit

    1–100

Response

  • 200Done.

    The action's result, exactly as the MCP tool returns it to agents. A next field, when present, names the endpoint that follows up.