Posts

Change one channel's settings on a post

Platform settings of one channel's version of a post that hasn't gone out; copy, media and time stay.

PATCHhttps://traceeai.com/api/v1/posts/{post_id}/channels/{channel_id}/settings

CLI:tracee posts settings·MCP:postsaction update_settings

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

  • post_idstringrequired

    The post, from GET /api/v1/posts (or the id POST /api/v1/posts returns)

    uuid

  • channel_idstringrequired

    The channel whose version to change. From GET /api/v1/connections

    uuid

Body

application/json
  • settingsobjectrequired

    Platform settings to set, e.g. {"visibility": "CONNECTIONS"}

    any keys

  • replace_settingsboolean

    Replace all settings instead of merging

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.