TraceeDocs

Posts

Delete a post

Deletes a post that never went out. Deleting through the API always asks a person first: the answer is 202 with the approval request.

DELhttps://traceeai.com/api/v1/posts/{postId}

CLI:tracee posts delete·MCP:postsaction delete

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

Query parameters

  • notestring

    Context for the person who approves it.

    up to 500 characters

Response

Errors
  • 200Deleted.DeleteResult
    • statusstringrequired

      Available options:deletedpending_approval

    • approvalRequestIdstring | nullrequired

      uuid

    • messagestring | nullrequired
    • postIdstringrequired

      uuid

  • 202Waiting for a person's approval.DeleteResult
    • statusstringrequired

      Available options:deletedpending_approval

    • approvalRequestIdstring | nullrequired

      uuid

    • messagestring | nullrequired
    • postIdstringrequired

      uuid