> ## 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 Tools By Profile History

> ListToolsByProfileHistory returns the transactional history of
 tools bound to (app, connector, access_profile). 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}/mcp_toolsets/{access_profile_id}/tool_bindings/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_toolsets/{access_profile_id}/tool_bindings/history:
    get:
      tags:
        - MCP Toolsets
      summary: List Tools By Profile History
      description: |-
        ListToolsByProfileHistory returns the transactional history of
         tools bound to (app, connector, access_profile). Newest first.
      operationId: >-
        c1.api.ai_governance.v1.MCPAccessProfileToolBindingService.ListToolsByProfileHistory
      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: access_profile_id
          required: true
          schema:
            description: Toolset (access profile) 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.MCPAccessProfileToolBindingServiceListToolsByProfileHistoryResponse
          description: Successful response
      x-codeSamples:
        - lang: typescript
          label: Typescript (SDK)
          source: >-
            import { ConductoroneSDKTypescript } from
            "conductorone-sdk-typescript";


            const conductoroneSDKTypescript = new ConductoroneSDKTypescript({
              security: {
                bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
                oauth: "<YOUR_OAUTH_HERE>",
              },
            });


            async function run() {
              const result = await conductoroneSDKTypescript.mcpAccessProfileToolBinding.listToolsByProfileHistory({
                appId: "<id>",
                connectorId: "<id>",
                accessProfileId: "<id>",
              });

              console.log(result);
            }


            run();
components:
  schemas:
    c1.api.ai_governance.v1.MCPAccessProfileToolBindingServiceListToolsByProfileHistoryResponse:
      description: >-
        The MCPAccessProfileToolBindingServiceListToolsByProfileHistoryResponse
        message.
      properties:
        list:
          description: The list field.
          items:
            $ref: >-
              #/components/schemas/c1.api.ai_governance.v1.MCPAccessProfileToolBindingHistoryEntry
          type:
            - array
            - 'null'
        nextPageToken:
          description: The nextPageToken field.
          type:
            - string
            - 'null'
      title: >-
        Mcp Access Profile Tool Binding Service List Tools By Profile History
        Response
      type: object
      x-speakeasy-name-override: MCPAccessProfileToolBindingServiceListToolsByProfileHistoryResponse
    c1.api.ai_governance.v1.MCPAccessProfileToolBindingHistoryEntry:
      description: |-
        MCPAccessProfileToolBindingHistoryEntry is one Tx.Commit's worth of
         adds/removes against the binding list. No snapshot field: the lists
         declare snapshot = false.
      properties:
        items:
          description: The items field.
          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: |-
        list_index is the mcp_tool_id on the per-profile surface, or the
         access_profile_id on the per-tool surface.
      properties:
        changeKind:
          description: The changeKind field.
          enum:
            - LIST_CHANGE_KIND_UNSPECIFIED
            - LIST_CHANGE_KIND_ADDED
            - LIST_CHANGE_KIND_REMOVED
          type:
            - string
            - 'null'
          x-speakeasy-unknown-values: allow
        listIndex:
          description: The listIndex field.
          type:
            - string
            - 'null'
      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
            - 'null'
        syslogEventId:
          description: |-
            System Log event id — KSUID of the OCSF event recorded for this
             transaction. Empty for non-RPC writes (workflows, cron).
          type:
            - string
            - 'null'
        traceId:
          description: 32-hex-char otel trace id or empty.
          type:
            - string
            - 'null'
      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
            - '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

````