---
title: "Get"
method: GET
path: "/api/v1/hooks/{id}"
tags: ["Hook"]
---

# Get

`GET /api/v1/hooks/{id}`

Invokes the c1.api.hooks.v1.HooksService.Get method.

## Path parameters

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

## Response `200`

Successful response

- C1ApiHooksV1HooksServiceGetResponse — The HooksServiceGetResponse message.
  - `hook` C1ApiHooksV1Hook — Hook represents a customer-configured interception point for tool calls. This message contains a oneof named hook_type. Only a single field of the following list may be set at a time: - function - builtinPattern
    - `builtinPattern` C1ApiHooksV1BuiltInPattern, nullable — BuiltInPattern references a ConductorOne-maintained DLP pattern. The specific pattern and its configuration are encoded as a oneof. This message contains a oneof named config. Only a single field of the following list may be set at a time: - piiRedaction - creditCardBlocking - queryScopeLimit - writeAuthorization - sensitiveFileGuard
      - `creditCardBlocking` C1ApiHooksV1CreditCardBlockingConfig, nullable — CreditCardBlockingConfig denies any tool call whose output contains a Luhn-valid credit card number. No configuration fields today; the presence of the oneof arm is the whole configuration.
      - `piiRedaction` C1ApiHooksV1PIIRedactionConfig, nullable — PIIRedactionConfig configures post-tool-use redaction of sensitive fields.
        - `redactFields` string[], nullable — The redactFields field.
        - `replacement` string — The replacement field.
      - `queryScopeLimit` C1ApiHooksV1QueryScopeLimitConfig, nullable — QueryScopeLimitConfig caps numeric fields (e.g. limit, page_size) in tool input so callers cannot request unbounded data.
        - `fields` string[], nullable — The fields field.
        - `maxLimit` integer — The maxLimit field.
      - `sensitiveFileGuard` C1ApiHooksV1SensitiveFileGuardConfig, nullable — SensitiveFileGuardConfig blocks tool calls that reference sensitive file paths or directories.
        - `blockedDirectories` string[], nullable — The blockedDirectories field.
        - `blockedPatterns` string[], nullable — The blockedPatterns field.
      - `writeAuthorization` C1ApiHooksV1WriteAuthorizationConfig, nullable — WriteAuthorizationConfig blocks tool calls whose ToolClassification is in blocked_classifications, optionally permitting them within business hours.
        - `blockedClassifications` string[], nullable — Tool classifications to block. Must have at least one entry; a hook with no blocked classifications would be a silent misconfiguration.
        - `businessHours` C1ApiHooksV1BusinessHours — BusinessHours defines a weekly time window in a specific timezone.
          - `days` integer[], nullable — 0=Sun, 1=Mon, ..., 6=Sat.
          - `end` string — "HH:MM" in 24-hour format.
          - `start` string — "HH:MM" in 24-hour format.
          - `timezone` string — The timezone field.
    - `createdAt` string, date-time
    - `description` string — The description field.
    - `displayName` string — The displayName field.
    - `enabled` boolean — The enabled field.
    - `event` 'HOOK_EVENT_TYPE_UNSPECIFIED' | 'HOOK_EVENT_TYPE_PRE_TOOL_USE' | 'HOOK_EVENT_TYPE_POST_TOOL_USE' — The event field.
    - `filter` C1ApiHooksV1HookFilter — HookFilter determines which tool calls a hook applies to.
      - `celExpression` string — CEL expression evaluated against tool call context. Available variable: ctx.tool_name (string). Must evaluate to bool. Empty matches all tools.
    - `function` C1ApiHooksV1HookFunctionRef, nullable — HookFunctionRef identifies a customer-authored function to invoke.
      - `commitId` string — If empty, the function's published commit is used at invocation time.
      - `functionId` string — The functionId field.
    - `id` string — The id field.
    - `priority` integer — The priority field.
    - `updatedAt` string, date-time

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/versions/d391405a35d3/schema)