> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ubik-agent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Détails d'un outil

> Récupère les informations détaillées d'un outil spécifique, si l'utilisateur dispose des permissions nécessaires.



## OpenAPI

````yaml /api-reference/openapi.fr.json get /tools/{tool_id}
openapi: 3.1.0
info:
  title: UBIK Public API
  description: Publicly accessible API endpoints for UBIK.
  version: '1.0'
servers:
  - url: https://app.ubik-agent.com/api/v1
    description: Production Server
security: []
paths:
  /tools/{tool_id}:
    get:
      tags:
        - Public API
        - Public API - Tools
      summary: Détails d'un outil
      description: >-
        Récupère les informations détaillées d'un outil spécifique, si
        l'utilisateur dispose des permissions nécessaires.
      operationId: get_public_tool_tools__tool_id__get
      parameters:
        - name: tool_id
          in: path
          required: true
          schema:
            type: string
            description: The unique identifier or name of the tool.
            title: Tool Id
          description: L'identifiant unique ou le nom de l'outil.
        - name: X-End-User-ID
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-End-User-Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicTool'
              example:
                id: d1e2f3a4-b5c6-7890-1234-567890abcdef
                name: Financial Data Extractor
                description: Extracts key financial metrics from annual reports.
                input_schema:
                  type: object
                  properties:
                    stock_symbol:
                      type: string
                      description: The stock symbol of the company.
                    report_year:
                      type: integer
                      description: The year of the financial report.
                  required:
                    - stock_symbol
                    - report_year
                media_output_keys: []
                example_responses:
                  - revenue: 1000000
                    profit: 250000
                pricing_config:
                  fixed_cost: 0.01
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    PublicTool:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: L'identifiant unique de l'outil.
        name:
          type: string
          title: Name
          description: Le nom de l'outil.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Une brève description de ce que fait l'outil.
        input_schema:
          $ref: '#/components/schemas/ToolInputSchema'
          description: Le schéma JSON définissant les entrées pour l'outil.
        media_output_keys:
          items:
            type: string
          type: array
          title: Media Output Keys
          description: Une liste de clés dans la sortie qui contiennent des URL de médias.
        example_responses:
          items:
            additionalProperties: true
            type: object
          type: array
          title: Example Responses
          description: >-
            Une liste d'exemples d'entrées et de leurs sorties correspondantes
            pour l'outil.
      type: object
      required:
        - id
        - name
        - input_schema
        - media_output_keys
        - example_responses
      title: PublicTool
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ToolInputSchema:
      properties:
        type:
          title: Type
          default: object
        properties:
          additionalProperties:
            $ref: '#/components/schemas/ToolPropertySchema'
          type: object
          title: Properties
          description: Un objet définissant les propriétés de l'objet d'entrée.
        required:
          items:
            type: string
          type: array
          title: Required
          description: Une liste des noms de propriétés qui sont requis.
        additionalProperties:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Additionalproperties
          default: false
        $defs:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/ToolPropertySchema'
              type: object
            - type: 'null'
          title: $Defs
      type: object
      title: ToolInputSchema
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    ToolPropertySchema:
      properties:
        $ref: c6fc8fbd-c06f-4bd0-a063-ceb046296093
        type:
          anyOf:
            - {}
            - type: 'null'
          title: Type
          description: Le type de données de la propriété (par ex., 'string', 'integer').
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Une description de ce que représente la propriété.
        enum:
          anyOf:
            - items:
                anyOf:
                  - type: string
                  - type: integer
                  - type: number
                  - type: 'null'
              type: array
            - type: 'null'
          title: Enum
          description: Une liste de valeurs possibles si la propriété est une énumération.
        properties:
          anyOf:
            - additionalProperties:
                $ref: '#/components/schemas/ToolPropertySchema'
              type: object
            - type: 'null'
          title: Properties
        items:
          anyOf:
            - $ref: '#/components/schemas/ToolPropertySchema'
            - items:
                $ref: '#/components/schemas/ToolPropertySchema'
              type: array
            - type: 'null'
          title: Items
        required:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Required
        additionalProperties:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Additionalproperties
        default:
          anyOf:
            - {}
            - type: 'null'
          title: Default
        format:
          anyOf:
            - type: string
            - type: 'null'
          title: Format
      type: object
      title: ToolPropertySchema
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-KEY

````