---
title: "Update"
method: POST
path: "/api/v1/tool_gates/{id}"
tags: ["Tool Gates"]
---

# Update

`POST /api/v1/tool_gates/{id}`

## Request

- Base URL: `https://example.conductor.one`
- URL: `https://example.conductor.one/api/v1/tool_gates/{id}`
- Auth: HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `/auth/v1/token`

Update modifies a tool gate's mutable fields.

## Path parameters

- `id` string, required: The id field.

## Request body

- C1ApiAiGovernanceV1ToolGatesServiceUpdateRequestInput: The ToolGatesServiceUpdateRequest message.
  - `toolGate` C1ApiAiGovernanceV1ToolGate, required: The ToolGate message.
    - `createdAt` string, date-time, nullable
    - `deletedAt` string, date-time, nullable
    - `description` string: The description field.
    - `displayName` string: The displayName field.
    - `enabled` boolean: The enabled field.
    - `filter` C1ApiAiGovernanceV1ToolGateFilter: The ToolGateFilter message.
      - `builtInPattern` 'TOOL_GATE_BUILT_IN_PATTERN_UNSPECIFIED' | 'TOOL_GATE_BUILT_IN_PATTERN_DESTRUCTIVE_ACTION' | 'TOOL_GATE_BUILT_IN_PATTERN_EXTERNAL_SEND' | 'TOOL_GATE_BUILT_IN_PATTERN_THIRD_PARTY_CONNECTOR' | 'TOOL_GATE_BUILT_IN_PATTERN_FINANCE_ACTION' | 'TOOL_GATE_BUILT_IN_PATTERN_INFRA_MUTATION' | 'TOOL_GATE_BUILT_IN_PATTERN_DB_WRITE': Built-in pattern selector: a named canned CEL filter maintained by ConductorOne. When set, cel_expression must be empty and is resolved from the registry at create time; the kind is retained for provenance.
      - `celExpression` string: The celExpression field.
    - `grantPolicyId` string: The grantPolicyId field.
    - `id` string: The id field.
    - `managedByGuardrails` boolean: The managedByGuardrails field.
    - `priority` integer: The priority field.
    - `tenantId` string: The tenantId field.
    - `updatedAt` string, date-time, nullable
  - `updateMask` string, nullable, required

## Response `200`

Successful response

- C1ApiAiGovernanceV1ToolGatesServiceUpdateResponse: The ToolGatesServiceUpdateResponse message.
  - `toolGate` C1ApiAiGovernanceV1ToolGate: The ToolGate message.
    - `createdAt` string, date-time, nullable
    - `deletedAt` string, date-time, nullable
    - `description` string: The description field.
    - `displayName` string: The displayName field.
    - `enabled` boolean: The enabled field.
    - `filter` C1ApiAiGovernanceV1ToolGateFilter: The ToolGateFilter message.
      - `builtInPattern` 'TOOL_GATE_BUILT_IN_PATTERN_UNSPECIFIED' | 'TOOL_GATE_BUILT_IN_PATTERN_DESTRUCTIVE_ACTION' | 'TOOL_GATE_BUILT_IN_PATTERN_EXTERNAL_SEND' | 'TOOL_GATE_BUILT_IN_PATTERN_THIRD_PARTY_CONNECTOR' | 'TOOL_GATE_BUILT_IN_PATTERN_FINANCE_ACTION' | 'TOOL_GATE_BUILT_IN_PATTERN_INFRA_MUTATION' | 'TOOL_GATE_BUILT_IN_PATTERN_DB_WRITE': Built-in pattern selector: a named canned CEL filter maintained by ConductorOne. When set, cel_expression must be empty and is resolved from the registry at create time; the kind is retained for provenance.
      - `celExpression` string: The celExpression field.
    - `grantPolicyId` string: The grantPolicyId field.
    - `id` string: The id field.
    - `managedByGuardrails` boolean: The managedByGuardrails field.
    - `priority` integer: The priority field.
    - `tenantId` string: The tenantId field.
    - `updatedAt` string, date-time, nullable

## Changes

- **2026-10-06** `918a4e749f56`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/conductorone/apis/c1-api/changes/api/v1/tool_gates/:id/post.md)

---

[API](https://skmtc.dev/conductorone/apis/c1-api.md) - [All operations](https://skmtc.dev/conductorone/apis/c1-api/llms.txt) - [OpenAPI document](https://skmtc.dev/conductorone/apis/c1-api/revisions/fe943bedf41b?raw)