> ## Documentation Index > Fetch the complete documentation index at: https://conductorone-docs-mcp-bridge-private-server.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List History > ListHistory returns the change history (newest first) for a single MCP tool — each entry is a snapshot plus who/when metadata. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/connectors/{connector_id}/mcp_tools/{id}/history openapi: 3.1.0 info: description: The C1 API is a HTTP API for managing C1 resources. title: C1 API version: 0.1.0-alpha servers: - description: The C1 API server for the current tenant. url: https://{tenantDomain}.conductor.one variables: tenantDomain: default: example description: The domain of the tenant to use for this request. security: - bearerAuth: [] oauth: [] paths: /api/v1/apps/{app_id}/connectors/{connector_id}/mcp_tools/{id}/history: get: tags: - MCP Tools summary: List History description: |- ListHistory returns the change history (newest first) for a single MCP tool — each entry is a snapshot plus who/when metadata. operationId: c1.api.ai_governance.v1.MCPToolService.ListHistory parameters: - in: path name: app_id required: true schema: description: App identifier. type: string - in: path name: connector_id required: true schema: description: Connector identifier. type: string - in: path name: id required: true schema: description: Unique identifier for the MCP tool. type: string - in: query name: page_size schema: description: Page size (max 200). format: int32 type: integer - in: query name: page_token schema: description: Page token for pagination. type: string responses: '200': content: application/json: schema: $ref: >- #/components/schemas/c1.api.ai_governance.v1.MCPToolServiceListHistoryResponse description: MCPToolServiceListHistoryResponse returns MCP tool history entries. x-codeSamples: - lang: typescript label: Typescript (SDK) source: >- import { ConductoroneSDKTypescript } from "conductorone-sdk-typescript"; const conductoroneSDKTypescript = new ConductoroneSDKTypescript({ security: { bearerAuth: "", oauth: "", }, }); async function run() { const result = await conductoroneSDKTypescript.mcpTool.listHistory({ appId: "", connectorId: "", id: "", }); console.log(result); } run(); components: schemas: c1.api.ai_governance.v1.MCPToolServiceListHistoryResponse: description: MCPToolServiceListHistoryResponse returns MCP tool history entries. properties: list: description: The list field. items: $ref: '#/components/schemas/c1.api.ai_governance.v1.MCPToolHistoryEntry' type: - array - 'null' nextPageToken: description: The nextPageToken field. type: - string - 'null' title: Mcp Tool Service List History Response type: object x-speakeasy-name-override: MCPToolServiceListHistoryResponse c1.api.ai_governance.v1.MCPToolHistoryEntry: description: >- MCPToolHistoryEntry is one version of an MCP tool and its history metadata. properties: metadata: oneOf: - $ref: '#/components/schemas/c1.api.history.v1.HistoryEntryMetadata' - type: 'null' snapshot: oneOf: - $ref: '#/components/schemas/c1.api.ai_governance.v1.MCPTool' - type: 'null' title: Mcp Tool History Entry type: object x-speakeasy-name-override: MCPToolHistoryEntry c1.api.history.v1.HistoryEntryMetadata: description: |- HistoryEntryMetadata is the shared metadata envelope embedded on every per-service HistoryEntry. The strongly-typed snapshot lives on the per-service entry message alongside this envelope. properties: actor: oneOf: - $ref: '#/components/schemas/c1.api.history.v1.HistoryActor' - type: 'null' annotations: description: |- Server-rendered annotations: known keys carry display_label and (for ticket_id, etc.) display_url resolved from tenant config. Cap mirrors the per-object annotation ceiling (16). items: $ref: '#/components/schemas/c1.api.history.v1.HistoryAnnotation' type: - array - 'null' changeKind: description: |- Storage-model enum re-exported here for wire compatibility with the storage row. UNSPECIFIED should never appear on the wire. enum: - CHANGE_KIND_UNSPECIFIED - CHANGE_KIND_CREATE - CHANGE_KIND_PUT - CHANGE_KIND_HARD_DELETE type: - string - 'null' x-speakeasy-unknown-values: allow createdAt: format: date-time type: - string - 'null' id: description: KSUID. Same value as c1.models.history.v1.ObjectHistory.id. type: - string - 'null' syslogEventId: description: |- System Log event id — KSUID of the OCSF event recorded for this write. Empty for non-RPC writes (workflows, cron). Customer-facing copy says "System Log event"; the underlying format is OCSF. type: - string - 'null' traceId: description: |- OTel trace correlation. Empty when no valid span at write time. 32-hex-char otel trace id or empty. type: - string - 'null' title: History Entry Metadata type: object x-speakeasy-name-override: HistoryEntryMetadata c1.api.ai_governance.v1.MCPTool: description: >- MCPTool represents metadata about individual tools discovered from an MCP server. properties: allowedClientTypes: description: |- Which client types may use this tool. Empty = all allowed types from tenant config. items: enum: - MCP_CLIENT_TYPE_UNSPECIFIED - MCP_CLIENT_TYPE_PERSONAL - MCP_CLIENT_TYPE_SHARED - MCP_CLIENT_TYPE_SERVICE - MCP_CLIENT_TYPE_EPHEMERAL type: string x-speakeasy-unknown-values: allow type: - array - 'null' appEntitlementId: description: Bound AppEntitlement created during sync. type: - string - 'null' appId: description: App identifier (app that owns the connector). type: - string - 'null' classification: description: Tool risk classification for policy decisions. enum: - TOOL_CLASSIFICATION_UNSPECIFIED - TOOL_CLASSIFICATION_READ - TOOL_CLASSIFICATION_WRITE - TOOL_CLASSIFICATION_DESTRUCTIVE - TOOL_CLASSIFICATION_SENSITIVE - TOOL_CLASSIFICATION_DANGEROUS type: - string - 'null' x-speakeasy-unknown-values: allow connectorId: description: Connector identifier. type: - string - 'null' createdAt: format: date-time type: - string - 'null' defaultClassification: description: >- Default tool classification from MCP config (system-managed during discovery). enum: - TOOL_CLASSIFICATION_UNSPECIFIED - TOOL_CLASSIFICATION_READ - TOOL_CLASSIFICATION_WRITE - TOOL_CLASSIFICATION_DESTRUCTIVE - TOOL_CLASSIFICATION_SENSITIVE - TOOL_CLASSIFICATION_DANGEROUS type: - string - 'null' x-speakeasy-unknown-values: allow defaultDisplayName: description: Default display name from MCP tool spec (title field). type: - string - 'null' defaultVisibility: description: >- System-managed default visibility from MCP config (set during discovery). enum: - TOOL_VISIBILITY_UNSPECIFIED - TOOL_VISIBILITY_FEATURED - TOOL_VISIBILITY_AVAILABLE - TOOL_VISIBILITY_BYPASSED type: - string - 'null' x-speakeasy-unknown-values: allow deletedAt: format: date-time type: - string - 'null' description: description: Admin-editable description. type: - string - 'null' discoveryHash: description: Hash of tool definition for change detection. type: - string - 'null' displayName: description: >- Admin-editable display name (overrides default_display_name when set). type: - string - 'null' id: description: Unique identifier for this MCP tool record. type: - string - 'null' inputSchemaJson: description: JSON-encoded input schema from MCP discovery. type: - string - 'null' lastCalledAt: format: date-time readOnly: true type: - string - 'null' state: description: Tool approval/lifecycle state. enum: - MCP_TOOL_STATE_UNSPECIFIED - MCP_TOOL_STATE_PENDING_REVIEW - MCP_TOOL_STATE_APPROVED - MCP_TOOL_STATE_DISABLED - MCP_TOOL_STATE_REMOVED type: - string - 'null' x-speakeasy-unknown-values: allow toolName: description: Native MCP tool name (unique within an MCP server). type: - string - 'null' updatedAt: format: date-time type: - string - 'null' visibility: description: >- Admin-settable visibility override (how this tool is surfaced to users). enum: - TOOL_VISIBILITY_UNSPECIFIED - TOOL_VISIBILITY_FEATURED - TOOL_VISIBILITY_AVAILABLE - TOOL_VISIBILITY_BYPASSED type: - string - 'null' x-speakeasy-unknown-values: allow title: Mcp Tool type: object x-speakeasy-name-override: MCPTool c1.api.history.v1.HistoryActor: description: |- HistoryActor is a typed reference to whoever performed the change. kind mirrors the storage-model ActorKind enum; user_id is set when kind corresponds to a user principal (API / SUPPORT) so the frontend can resolve the user via its own avatar / lookup hooks. Protos reference objects by id; the frontend renders / caches itself. The raw passport fields (token_id / principal_id) intentionally do not leave the server. Non-user actors (workflow, connector, internal) are identified by `kind` alone; correlating IDs (workflow_run_id, etc.) flow through `HistoryAnnotation` instead of being plucked into the actor message. properties: kind: description: The kind field. enum: - ACTOR_KIND_UNSPECIFIED - ACTOR_KIND_API - ACTOR_KIND_SLACK - ACTOR_KIND_MSTEAMS - ACTOR_KIND_JIRA_CLOUD - ACTOR_KIND_INTERNAL - ACTOR_KIND_SUPPORT - ACTOR_KIND_WORKFLOW type: - string - 'null' x-speakeasy-unknown-values: allow userId: description: |- Bare KSUID. Set when kind = ACTOR_KIND_API or ACTOR_KIND_SUPPORT. Empty otherwise. The frontend resolves user_id → display name via the same lookup paths it uses elsewhere (avatars, mentions, ...). type: - string - 'null' title: History Actor type: object x-speakeasy-name-override: HistoryActor c1.api.history.v1.HistoryAnnotation: description: |- HistoryAnnotation is a single operator-provided key/value rendered with per-key display metadata. Annotations are minted from the Tx.*WithHistoryAnnotations / db.WithHistoryAnnotations call options. properties: displayLabel: description: Server-rendered label, e.g. "Ticket". type: - string - 'null' displayUrl: description: |- Resolved from tenant config; "" if none. Frontend applies its own scheme allowlist. type: - string - 'null' displayValue: description: UI-friendly rendering (truncated / reshaped from raw_value). type: - string - 'null' key: description: 'Storage-side key. Bounds: ^[a-z][a-z0-9_.-]{0,63}$.' type: - string - 'null' kind: description: The kind field. enum: - ANNOTATION_KIND_UNSPECIFIED - ANNOTATION_KIND_GENERIC - ANNOTATION_KIND_TICKET - ANNOTATION_KIND_REASON - ANNOTATION_KIND_WORKFLOW - ANNOTATION_KIND_BATCH - ANNOTATION_KIND_CORRELATION - ANNOTATION_KIND_AUTOMATION type: - string - 'null' x-speakeasy-unknown-values: allow rawValue: description: >- Raw value as stored in ObjectHistory.annotations; storage-side values are capped at 512 bytes. type: - string - 'null' title: History Annotation type: object x-speakeasy-name-override: HistoryAnnotation securitySchemes: bearerAuth: scheme: bearer type: http oauth: description: >- This API uses OAuth2 with the Client Credential flow. Client Credentials must be sent in the BODY, not the headers. For an example of how to implement this, refer to the [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187) function. flows: clientCredentials: scopes: {} tokenUrl: /auth/v1/token type: oauth2 ````