> ## Documentation Index > Fetch the complete documentation index at: https://conductorone-lee-google-cloud-project-mcp-setup.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Profiles By Tool History > ListProfilesByToolHistory returns the transactional history of profiles bound to (app, connector, mcp_tool). Newest first. ## OpenAPI ````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/connectors/{connector_id}/tool_bindings/by_tool/{mcp_tool_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}/tool_bindings/by_tool/{mcp_tool_id}/history: get: tags: - MCP Toolsets summary: List Profiles By Tool History description: |- ListProfilesByToolHistory returns the transactional history of profiles bound to (app, connector, mcp_tool). Newest first. operationId: >- c1.api.ai_governance.v1.MCPAccessProfileToolBindingService.ListProfilesByToolHistory 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: mcp_tool_id required: true schema: description: MCP tool identifier. 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.MCPAccessProfileToolBindingServiceListProfilesByToolHistoryResponse description: >- Contains a page of change-history entries for the toolsets one tool has belonged to, sorted newest first. x-codeSamples: - lang: go label: ListProfilesByToolHistory source: "package main\n\nimport(\n\t\"context\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/shared\"\n\tconductoronesdkgo \"github.com/conductorone/conductorone-sdk-go\"\n\t\"github.com/conductorone/conductorone-sdk-go/pkg/models/operations\"\n\t\"log\"\n)\n\nfunc main() {\n ctx := context.Background()\n\n s := conductoronesdkgo.New(\n conductoronesdkgo.WithSecurity(shared.Security{\n BearerAuth: \"\",\n Oauth: \"\",\n }),\n )\n\n res, err := s.MCPAccessProfileToolBinding.ListProfilesByToolHistory(ctx, operations.C1APIAiGovernanceV1MCPAccessProfileToolBindingServiceListProfilesByToolHistoryRequest{\n AppID: \"\",\n ConnectorID: \"\",\n McpToolID: \"\",\n })\n if err != nil {\n log.Fatal(err)\n }\n if res.MCPAccessProfileToolBindingServiceListProfilesByToolHistoryResponse != nil {\n // handle response\n }\n}" - 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.mcpAccessProfileToolBinding.listProfilesByToolHistory({ appId: "", connectorId: "", mcpToolId: "", }); console.log(result); } run(); components: schemas: c1.api.ai_governance.v1.MCPAccessProfileToolBindingServiceListProfilesByToolHistoryResponse: description: >- Contains a page of change-history entries for the toolsets one tool has belonged to, sorted newest first. properties: list: description: The page of history entries, newest first. items: $ref: >- #/components/schemas/c1.api.ai_governance.v1.MCPAccessProfileToolBindingHistoryEntry type: - array - 'null' nextPageToken: description: >- Pagination token for the next page, or empty if there are no more results. type: string title: >- Mcp Access Profile Tool Binding Service List Profiles By Tool History Response type: object x-speakeasy-name-override: MCPAccessProfileToolBindingServiceListProfilesByToolHistoryResponse c1.api.ai_governance.v1.MCPAccessProfileToolBindingHistoryEntry: description: >- MCPAccessProfileToolBindingHistoryEntry is a single change-history record capturing the tool bindings added or removed in one transaction. properties: items: description: The bindings added or removed in this change. items: $ref: >- #/components/schemas/c1.api.ai_governance.v1.MCPAccessProfileToolBindingHistoryItem type: - array - 'null' metadata: oneOf: - $ref: '#/components/schemas/c1.api.history.v1.ListHistoryEntryMetadata' - type: 'null' title: Mcp Access Profile Tool Binding History Entry type: object x-speakeasy-name-override: MCPAccessProfileToolBindingHistoryEntry c1.api.ai_governance.v1.MCPAccessProfileToolBindingHistoryItem: description: >- MCPAccessProfileToolBindingHistoryItem is a single binding added or removed in a transaction. properties: changeKind: description: Whether this binding was added or removed. enum: - LIST_CHANGE_KIND_UNSPECIFIED - LIST_CHANGE_KIND_ADDED - LIST_CHANGE_KIND_REMOVED type: string x-speakeasy-unknown-values: allow listIndex: description: >- The identifier of the other side of the binding: the tool ID when viewing a toolset's history, or the toolset ID when viewing a tool's history. type: string title: Mcp Access Profile Tool Binding History Item type: object x-speakeasy-name-override: MCPAccessProfileToolBindingHistoryItem c1.api.history.v1.ListHistoryEntryMetadata: description: ListHistoryEntryMetadata is the per-transaction metadata envelope. properties: actor: oneOf: - $ref: '#/components/schemas/c1.api.history.v1.HistoryActor' - type: 'null' annotations: description: Server-rendered annotations (mirrors object_history). items: $ref: '#/components/schemas/c1.api.history.v1.HistoryAnnotation' type: - array - 'null' createdAt: format: date-time type: - string - 'null' id: description: KSUID. Same value as c1.models.history.v1.ListHistory.id. type: string syslogEventId: description: |- System Log event id — KSUID of the OCSF event recorded for this transaction. Empty for non-RPC writes (workflows, cron). type: string traceId: description: 32-hex-char otel trace id or empty. type: string title: List History Entry Metadata type: object x-speakeasy-name-override: ListHistoryEntryMetadata 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 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 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 displayUrl: description: |- Resolved from tenant config; "" if none. Frontend applies its own scheme allowlist. type: string displayValue: description: UI-friendly rendering (truncated / reshaped from raw_value). type: string key: description: 'Storage-side key. Bounds: ^[a-z][a-z0-9_.-]{0,63}$.' type: string 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 x-speakeasy-unknown-values: allow rawValue: description: >- Raw value as stored in ObjectHistory.annotations; storage-side values are capped at 512 bytes. type: string 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 ````