Archive a tool set

Transitions a tool set to STATE_ARCHIVED. Syncing stops, the tool set is hidden from list results, its tools are no longer offered to objectives, and new variation assignments are rejected. Existing assignments are retained, and history is preserved — unlike delete, archiving works while the tool set is still assigned to agent variations.

post/v1/workspaces/{workspaceId}/tool_sets/{id}:archive

Path parameters

workspaceIdstring required

Example:workspace_01HXKD2E5NQM3T9AYWCF133E3Q

Workspace ID.

idstring required

Example:toolset_01HXKD2E5NQM3T9AYWCFNRMN74

Tool set ID. Accepts the canonical ts_… form or the external_id:<value> form.

Request body

workspaceIdstring

Workspace ID.

idstring

Tool set ID. Accepts the canonical ts_… form or the external_id:<value> form.

Example request

{
  "workspaceId": "workspace_01HXKD2E5NQM3T9AYWCF133E3Q",
  "id": "toolset_01HXKD2E5NQM3T9AYWCFNRMN74"
}

Response

state'STATE_UNSPECIFIED' | 'STATE_ACTIVE' | 'STATE_ARCHIVED' enum required

The current lifecycle state of the tool set. Output only. Tool sets are created STATE_ACTIVE; use the :archive and :unarchive actions to transition between states.

Changes

Changed in 5 of the 57 revisions of this API.257

Jul 19, 20263ecc1debabfa241See the full diff
- ▲
  added ToolSetAdapter_McpVariant ToolSetAdapter_HttpVariant ToolSetAdapter_OpenapiVariant ToolSetAdapter_BareVariant to the spec/adapter response property oneOf list for the response status 200
  response-property-one-of-added
- ▲
  the spec/adapter response's property type/format changed from object/ to / for status 200
  response-property-type-changed
- ●
  removed the optional property spec/adapter/bare from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property spec/adapter/http from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property spec/adapter/mcp from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property spec/adapter/openapi from the response with the 200 status
  response-optional-property-removed
- ○
  added discriminator to spec/adapter response property for the response status 200
  response-property-discriminator-added
Jul 6, 2026ca78d3d0b7c21See the full diff
- ○
  added the optional property spec/adapter/bare to the response with the 200 status
  response-optional-property-added
Jul 3, 202602498bf606f01See the full diff
- ○
  added the optional property spec/adapter/mcp/justInTime to the response with the 200 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jul 2, 202606e0e37c149913See the full diff
- ●
  removed the optional property metadata/bundleKey from the response with the 200 status
  response-optional-property-removed
- ○
  added the optional property info/allOf[ToolSetInfo]/availableTools to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property info/allOf[ToolSetInfo]/createdBy/metadata/createdAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property info/allOf[ToolSetInfo]/omittedTools to the response with the 200 status
  response-optional-property-added
This revision also has 27 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 9, 202613d98d37dd961See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history