> ## Documentation Index
> Fetch the complete documentation index at: https://wildcard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Tool Selection

> Performs a search within the specified collection using a natural language query to find the most relevant tool.




## OpenAPI

````yaml wildcard_openapi.yaml get /search
openapi: 3.0.0
info:
  title: Wildcard API
  version: 0.2.0
  description: >
    The Wildcard API allows finding the right tools to execute for natural
    language inputs.
  contact:
    name: Wildcard Support
    url: https://wild-card.ai
    email: info@wild-card.ai
servers:
  - url: https://api.wild-card.ai
security: []
paths:
  /search:
    get:
      tags:
        - Search
        - Collections
      summary: Tool Selection
      description: >
        Performs a search within the specified collection using a natural
        language query to find the most relevant tool.
      operationId: semantic_search_search_get
      parameters:
        - name: query
          in: query
          required: true
          description: The search query string.
          schema:
            type: string
            title: Query
        - name: collection_id
          in: query
          required: true
          description: >-
            The ID of the collection to search within (e.g.,
            "c58a5915-7b28-49b1-a28d-d81ffc6f63ea").
          schema:
            type: string
            title: Collection ID
            example: c58a5915-7b28-49b1-a28d-d81ffc6f63ea
        - name: X-API-Key
          in: header
          required: true
          description: >-
            The API key for authenticating the request. You can find your API
            key in the Wildcard dashboard.
          schema:
            type: string
            title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  points:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the search result
                        version:
                          type: integer
                          description: Version number of the result
                        score:
                          type: number
                          format: float
                          description: Relevance score of the search result
                        payload:
                          type: object
                          properties:
                            agentsJson:
                              type: string
                              description: Version of the agents JSON format
                            info:
                              type: object
                              properties:
                                title:
                                  type: string
                                  description: Title of the API integration
                                version:
                                  type: string
                                  description: Version of the API integration
                                description:
                                  type: string
                                  description: Detailed description of the API integration
                            sources:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    description: Unique identifier for the source
                                  path:
                                    type: string
                                    description: >-
                                      Path or URL to the source OpenAPI
                                      specification
                            overrides:
                              type: array
                              description: List of overrides for the API integration
                            flows:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    description: Unique identifier for the flow
                                  title:
                                    type: string
                                    description: Title of the flow
                                  description:
                                    type: string
                                    description: Description of the flow
                                  actions:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        id:
                                          type: string
                                          description: Unique identifier for the action
                                        sourceId:
                                          type: string
                                          description: Reference to the source ID
                                        operationId:
                                          type: string
                                          description: >-
                                            Operation ID from the OpenAPI
                                            specification
                                  links:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        origin:
                                          type: object
                                          properties:
                                            actionId:
                                              type: string
                                              description: ID of the origin action
                                            fieldPath:
                                              type: string
                                              description: Path to the field in the origin
                                        target:
                                          type: object
                                          properties:
                                            actionId:
                                              type: string
                                              description: ID of the target action
                                            fieldPath:
                                              type: string
                                              description: Path to the field in the target
                                  fields:
                                    type: object
                                    properties:
                                      parameters:
                                        type: array
                                        description: List of parameters for the flow
                                      requestBody:
                                        type: object
                                        properties:
                                          content:
                                            type: object
                                            additionalProperties:
                                              type: object
                                              properties:
                                                schema:
                                                  type: object
                                                  description: JSON Schema for the request body
                                                example:
                                                  type: object
                                                  description: Example request body
                                          required:
                                            type: boolean
                                            description: Whether the request body is required
                                      responses:
                                        type: object
                                        properties:
                                          success:
                                            type: object
                                            description: Schema for successful response
                        vector:
                          type: array
                          items:
                            type: number
                          nullable: true
                          description: Vector representation of the result (if available)
                        shard_key:
                          type: string
                          nullable: true
                          description: Shard key for distributed storage
                        order_value:
                          type: number
                          nullable: true
                          description: Value used for ordering results
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    HTTPValidationError:
      title: HTTPValidationError
      description: >-
        Schema for HTTP validation errors returned when request parameters fail
        validation.
      type: object
      properties:
        detail:
          title: Detail
          type: array
          items:
            $ref: '#/components/schemas/ValidationError'
    ValidationError:
      title: ValidationError
      description: Detailed information about a specific validation error.
      type: object
      required:
        - loc
        - msg
        - type
      properties:
        loc:
          title: Location
          type: array
          items:
            anyOf:
              - type: string
              - type: integer
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string

````