---
title: "Update Tool Status"
method: PATCH
path: "/tools/v1/tool/{tool_id}"
---

# Update Tool Status

`PATCH /tools/v1/tool/{tool_id}`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/tools/v1/tool/{tool_id}`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Actualiza el status de una tool (ON/OFF).
Requiere permisos de administrator.

Args:
    tool_id: ID de la tool a actualizar
    body: Datos con el nuevo status
    authenticated_user: Usuario autenticado
    handler: Handler para procesar la actualización
    
Returns:
    UpdateToolStatusResponse: Tool actualizada
    
Raises:
    HTTPException 403: User is not admin
    HTTPException 404: Tool not found
    HTTPException 422: Status inválido

## Path parameters

- `tool_id` string, required

## Request body

- UpdateToolStatusBody: Body del request HTTP para actualizar el status de una tool.
  - `status` 'ON' | 'OFF', required

## Response `200`

Successful Response

- UpdateToolStatusResponse: Response DTO para la actualización del status de una tool.
  - `tool_id` string, required
  - `status` 'ON' | 'OFF', required
  - `message` string, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)