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

# Créer un outil

> Créer un nouvel outil

## Requête

```bash theme={null}
curl -X POST https://app.orova.ai/api/tools \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Check Order Status",
    "type": "http",
    "description": "Use when the caller asks about their order status",
    "workspaceId": "WORKSPACE_ID",
    "config": {
      "method": "GET",
      "url": "https://api.yourcompany.com/orders/{order_id}",
      "headers": {
        "Authorization": "Bearer YOUR_BACKEND_TOKEN"
      }
    },
    "parameters": [
      {
        "name": "order_id",
        "description": "The customer order number",
        "required": true
      }
    ]
  }'
```

## Paramètres

| Champ         | Type   | Requis | Description                                                |
| ------------- | ------ | ------ | ---------------------------------------------------------- |
| `name`        | string | Oui    | Nom d'affichage de l'outil                                 |
| `type`        | string | Oui    | Type d'outil : `http`, `integration` ou `transfer`         |
| `description` | string | Oui    | Indique à l'agent quand utiliser cet outil                 |
| `workspaceId` | string | Oui    | ID de l'espace de travail                                  |
| `templateId`  | string | Non    | ID du modèle d'intégration (pour les outils d'intégration) |
| `config`      | object | Non    | Configuration HTTP : `method`, `url`, `headers`, `body`    |
| `parameters`  | array  | Non    | Paramètres que l'agent extrait de la conversation          |

## Réponse

```json theme={null}
{
  "_id": "tool_abc123",
  "name": "Check Order Status",
  "type": "http",
  "description": "Use when the caller asks about their order status",
  "workspaceId": "WORKSPACE_ID",
  "config": {
    "method": "GET",
    "url": "https://api.yourcompany.com/orders/{order_id}"
  },
  "createdAt": "2025-01-01T00:00:00.000Z"
}
```