TraceeDocs

Posts

List posts

Posts, newest first. from and to filter by when a post goes (or went) out; drafts with no planned time are left out of a window.

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

CLI:tracee posts list·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

  • fromstring

    Start of the window: a date (2026-11-09) or an ISO 8601 date-time.

  • tostring

    End of the window (exclusive). A date means through the end of that day.

  • statusstring

    One status or several separated by commas: draft, pending_approval, approved, rejected, scheduled, published, partially_published, failed, removed.

  • limitintegerdefault: 20

    Items per page.

    1–100

  • cursorstring

    nextCursor from the previous page.

Response

Errors
  • 200A page of posts.PostList
    • dataobject[]required
    • nextCursorstring | nullrequired

      Pass as `cursor` to get the next page; null on the last page.