Skip to navigation

Review changes before publication

Compares current authoring configuration with the live version. Credentials are redacted by structure. ETag identifies the complete reviewed configuration. The ETag is the publication token. It covers the draft revision, the revision of each bound tool, the revision of each referenced MCP server, each pinned secret version, the direct agent library membership and source state/revision, and the default-tool policy. A change to any of them, including an MCP server edit shared by several agents, changes the token.

Authentication

AuthorizationBearer

Create and manage workspace-owned keys through the existing app session routes, outside this public API. Creator and manager identities are audit actors only. Key validity follows workspace policy, expiry and explicit revocation, independently of creator membership. Do not include a workspace-selection header.

Path parameters

agent_idstringRequired1-128 characters
Resource identity within the authenticated workspace.

Response headers

X-Request-IdstringOptional
Safe server request correlation ID.
ETagstringOptional

Publication token: covers the draft revision, bound tool revisions, referenced MCP server revisions, pinned secret versions, the direct agent library membership and source state/revision, and the default-tool policy. Send it as If-Match to publishAgent and to draft edits.

RateLimit-LimitintegerOptional
Requests allowed in the current window for the tightest applicable limit.
RateLimit-RemainingintegerOptional
Requests left in the current window.
RateLimit-ResetintegerOptional
Seconds until the current window resets.

Response

Review changes before publication.
agent_idstring<=128 characters
Opaque agent identifier. Do not parse its contents.
base_version_idstring or null<=128 characters
draft_revisionstring
changeslist of objects

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error