> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-claude-gcp-connector-org-level-role.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Search

> Search returns a connector's MCP resources filtered by kind, state, or
 text query. Filter on MCP_RESOURCE_STATE_PENDING_REVIEW to find resources
 awaiting approval, then approve them with Update.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples post /api/v1/apps/{app_id}/connectors/{connector_id}/mcp_resources/search
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_resources/search:
    post:
      tags:
        - MCP Resources
      summary: Search
      description: |-
        Search returns a connector's MCP resources filtered by kind, state, or
         text query. Filter on MCP_RESOURCE_STATE_PENDING_REVIEW to find resources
         awaiting approval, then approve them with Update.
      operationId: c1.api.ai_governance.v1.MCPResourceService.Search
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: App identifier (required).
            type: string
        - in: path
          name: connector_id
          required: true
          schema:
            description: Connector ID (required).
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: >-
                #/components/schemas/c1.api.ai_governance.v1.MCPResourceServiceSearchRequestInput
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.ai_governance.v1.MCPResourceServiceSearchResponse
          description: MCPResourceServiceSearchResponse returns matching MCP resources.
components:
  schemas:
    c1.api.ai_governance.v1.MCPResourceServiceSearchRequestInput:
      description: MCPResourceServiceSearchRequest searches MCP resources with filters.
      properties:
        includeGrantStatus:
          description: |-
            When true, the server populates the computed entitlement_active and
             grant_count fields on each returned row (an extra batched entitlement
             lookup per page). Off by default so callers that don't render grant
             status don't pay for it.
          type: boolean
        kindFilter:
          description: Optional filter by resource kind. An empty list means no filter.
          items:
            enum:
              - MCP_RESOURCE_KIND_UNSPECIFIED
              - MCP_RESOURCE_KIND_STATIC
              - MCP_RESOURCE_KIND_TEMPLATE
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
        pageSize:
          description: Page size (max 100).
          format: int32
          type: integer
        pageToken:
          description: Page token for pagination.
          type: string
        query:
          description: >-
            Optional text query matched against name, title, description, and
            uri.
          type: string
        sortBy:
          description: >-
            Sort order for results. UNSPECIFIED sorts by resource name
            ascending.
          enum:
            - MCP_RESOURCE_SORT_BY_UNSPECIFIED
            - MCP_RESOURCE_SORT_BY_NAME
            - MCP_RESOURCE_SORT_BY_URI
            - MCP_RESOURCE_SORT_BY_STATE
            - MCP_RESOURCE_SORT_BY_UPDATED_AT
          type: string
          x-speakeasy-unknown-values: allow
        sortDirection:
          description: Direction for sort_by. UNSPECIFIED means ascending.
          enum:
            - SORT_DIRECTION_UNSPECIFIED
            - SORT_DIRECTION_ASC
            - SORT_DIRECTION_DESC
          type: string
          x-speakeasy-unknown-values: allow
        stateFilter:
          description: |-
            Optional filter by resource state. An empty list defaults to
             PENDING_REVIEW, APPROVED, and DISABLED (REMOVED is hidden unless
             explicitly requested).
          items:
            enum:
              - MCP_RESOURCE_STATE_UNSPECIFIED
              - MCP_RESOURCE_STATE_PENDING_REVIEW
              - MCP_RESOURCE_STATE_APPROVED
              - MCP_RESOURCE_STATE_DISABLED
              - MCP_RESOURCE_STATE_REMOVED
            type: string
            x-speakeasy-unknown-values: allow
          type:
            - array
            - 'null'
      title: Mcp Resource Service Search Request
      type: object
      x-speakeasy-name-override: MCPResourceServiceSearchRequest
    c1.api.ai_governance.v1.MCPResourceServiceSearchResponse:
      description: MCPResourceServiceSearchResponse returns matching MCP resources.
      properties:
        list:
          description: Matching MCP resources.
          items:
            $ref: '#/components/schemas/c1.api.ai_governance.v1.MCPResource'
          type:
            - array
            - 'null'
        nextPageToken:
          description: Token for next page.
          type: string
      title: Mcp Resource Service Search Response
      type: object
      x-speakeasy-name-override: MCPResourceServiceSearchResponse
    c1.api.ai_governance.v1.MCPResource:
      description: >-
        MCPResource represents metadata about an individual resource discovered
        from an MCP server.
      properties:
        appEntitlementId:
          description: Bound AppEntitlement created during sync.
          type: string
        appId:
          description: App identifier (app that owns the connector).
          type: string
        connectorId:
          description: Connector identifier.
          type: string
        createdAt:
          format: date-time
          type:
            - string
            - 'null'
        deletedAt:
          format: date-time
          type:
            - string
            - 'null'
        description:
          description: Description from the MCP resource spec.
          type: string
        discoveryHash:
          description: Hash of resource definition for change detection.
          type: string
        entitlementActive:
          description: >-
            Whether the bound app entitlement exists and is not deleted.
            Computed
             read-only; populated on Search only when the request had
             include_grant_status = true; ignored on write.
          readOnly: true
          type: boolean
        grantCount:
          description: >-
            Number of active grants on the bound app entitlement. Computed
            read-only;
             populated on Search only when the request had include_grant_status = true;
             ignored on write.
          format: int64
          readOnly: true
          type: string
        id:
          description: Unique identifier for this MCP resource record.
          type: string
        kind:
          description: Whether this is a static resource or a URI template.
          enum:
            - MCP_RESOURCE_KIND_UNSPECIFIED
            - MCP_RESOURCE_KIND_STATIC
            - MCP_RESOURCE_KIND_TEMPLATE
          type: string
          x-speakeasy-unknown-values: allow
        lastDiscoveredAt:
          format: date-time
          type:
            - string
            - 'null'
        mimeType:
          description: MIME type of the resource content, when known.
          type: string
        name:
          description: Native MCP resource name (unique within an MCP server).
          type: string
        state:
          description: Resource approval/lifecycle state.
          enum:
            - MCP_RESOURCE_STATE_UNSPECIFIED
            - MCP_RESOURCE_STATE_PENDING_REVIEW
            - MCP_RESOURCE_STATE_APPROVED
            - MCP_RESOURCE_STATE_DISABLED
            - MCP_RESOURCE_STATE_REMOVED
          type: string
          x-speakeasy-unknown-values: allow
        title:
          description: Human-readable title from the MCP resource spec.
          type: string
        updatedAt:
          format: date-time
          type:
            - string
            - 'null'
        uri:
          description: Raw resource URI from MCP discovery (set for STATIC resources).
          type: string
        uriTemplate:
          description: >-
            Raw RFC 6570 URI template from MCP discovery (set for TEMPLATE
            resources).
          type: string
      title: Mcp Resource
      type: object
      x-speakeasy-name-override: MCPResource
  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

````