> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-terraform-v2-owner-resources.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Top Tools

> ListTopTools returns the app's most-called tools (application_name +
 application_operation), ordered by call count descending, for the same
 app-scoped Edge set and window as ListTrafficEvents.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/traffic-top-tools
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}/traffic-top-tools:
    get:
      tags:
        - Time Bandit Control Plane
      summary: List Top Tools
      description: |-
        ListTopTools returns the app's most-called tools (application_name +
         application_operation), ordered by call count descending, for the same
         app-scoped Edge set and window as ListTrafficEvents.
      operationId: c1.api.tbcontrolplane.v1.TBControlPlaneService.ListTopTools
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: The appId field.
            type: string
        - in: query
          name: page_size
          schema:
            description: |-
              0 defaults to 20, clamped to [1, 200] -- same contract as
               ListTrafficEventsRequest.page_size.
            format: int32
            type: integer
        - in: query
          name: since
          schema:
            description: The since field.
            format: int64
            type: string
        - in: query
          name: until
          schema:
            description: The until field.
            format: int64
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.tbcontrolplane.v1.TBControlPlaneServiceListTopToolsResponse
          description: Successful response
components:
  schemas:
    c1.api.tbcontrolplane.v1.TBControlPlaneServiceListTopToolsResponse:
      description: The TBControlPlaneServiceListTopToolsResponse message.
      properties:
        tools:
          description: >-
            Ordered by call_count descending, limited to page_size. No
            pagination
             cursor -- this is a fixed top-N, not a full list.
          items:
            $ref: '#/components/schemas/c1.api.tbcontrolplane.v1.TBTopTool'
          type:
            - array
            - 'null'
      title: Tb Control Plane Service List Top Tools Response
      type: object
      x-speakeasy-name-override: TBControlPlaneServiceListTopToolsResponse
    c1.api.tbcontrolplane.v1.TBTopTool:
      description: TBTopTool is one (application_name, application_operation) group.
      properties:
        allowedCount:
          description: The allowedCount field.
          format: uint64
          type: string
        callCount:
          description: The callCount field.
          format: uint64
          type: string
        deniedCount:
          description: The deniedCount field.
          format: uint64
          type: string
        distinctAgentCount:
          description: The distinctAgentCount field.
          format: uint64
          type: string
        toolName:
          description: The toolName field.
          type: string
        toolOperation:
          description: The toolOperation field.
          type: string
        totalResponseBytes:
          description: The totalResponseBytes field.
          format: uint64
          type: string
      title: Tb Top Tool
      type: object
      x-speakeasy-name-override: TBTopTool
  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

````