TraceeDocs

Posts

Publish or schedule a post

Publishes now, or at scheduledFor. If the workspace requires approval the post waits in a person's inbox (202) and goes out once approved.

POSThttps://traceeai.com/api/v1/posts/{postId}/publish

CLI:tracee posts publish·MCP:postsaction publish

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

Path parameters

  • postIdstringrequired

    uuid

Body

application/json
  • scheduledForstring

    Publish at this time instead of now. Must be in the future.

    date-time

  • notestring

    Context for the person who approves it.

    up to 500 characters

Response

Errors
  • 200Published, scheduled, or failed per channel.PublishResult
    • statusstringrequired

      pending_approval: waiting in a person's approval inbox; it publishes once approved.

      Available options:pending_approvalscheduledpublishedpartially_publishedfailed

    • approvalRequestIdstring | nullrequired

      Set when status is pending_approval.

      uuid

    • messagestring | nullrequired
    • postobjectrequired
  • 202Waiting for a person's approval.PublishResult
    • statusstringrequired

      pending_approval: waiting in a person's approval inbox; it publishes once approved.

      Available options:pending_approvalscheduledpublishedpartially_publishedfailed

    • approvalRequestIdstring | nullrequired

      Set when status is pending_approval.

      uuid

    • messagestring | nullrequired
    • postobjectrequired