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

# Listar y buscar herramientas y carpetas

> Lista un nivel de carpeta (`folderId`, la raíz por defecto) o toda la empresa (`scope=company`). Una búsqueda (`q`) abarca toda la empresa y también devuelve las carpetas que coinciden. Los elementos de todos los tipos (woku, nps, csat, ces) vienen en una sola lista paginada por cursor, con conteos por faceta de cada tipo.



## OpenAPI

````yaml /openapi-v1.es.json get /v1/tools
openapi: 3.0.0
info:
  title: Woku Client API v1
  description: >-
    API REST pública para la administración programática de programas
    Voice-of-Customer de woku: trackers, instrumentos VoC (NPS, woku, CES,
    CSAT), planes de acción, tickets de soporte, envío multicanal y captura de
    respuestas. Las solicitudes están delimitadas por empresa mediante la clave
    API. Nunca envíe un id de empresa.
  version: 1.0.0
  contact:
    name: Woku
    url: https://woku.app
    email: team@woku.app
servers:
  - url: https://clientapi.woku.app
    description: Producción
security: []
tags: []
paths:
  /v1/tools:
    get:
      tags:
        - v1 - tools
      summary: Listar y buscar herramientas y carpetas
      description: >-
        Lista un nivel de carpeta (`folderId`, la raíz por defecto) o toda la
        empresa (`scope=company`). Una búsqueda (`q`) abarca toda la empresa y
        también devuelve las carpetas que coinciden. Los elementos de todos los
        tipos (woku, nps, csat, ces) vienen en una sola lista paginada por
        cursor, con conteos por faceta de cada tipo.
      operationId: V1ToolsController_listTools
      parameters:
        - name: scope
          required: false
          in: query
          description: >-
            `level` (por defecto) lista un nivel de carpeta; `company` es una
            lista plana de todas las herramientas de la empresa.
          schema:
            type: string
            enum:
              - level
              - company
        - name: types
          required: false
          in: query
          description: 'Tipos de herramienta separados por coma: woku, nps, csat, ces.'
          schema:
            type: array
            items:
              type: string
        - name: q
          required: false
          in: query
          description: >-
            Búsqueda en nombres y preguntas, sin distinguir mayúsculas ni
            acentos. Una búsqueda abarca toda la empresa y también coincide con
            nombres de carpetas.
          schema:
            maxLength: 100
            type: string
        - name: sort
          required: false
          in: query
          schema:
            default: name
            type: string
            enum:
              - name
              - '-name'
              - created
              - '-created'
        - name: cursor
          required: false
          in: query
          description: '`nextCursor` opaco de la página anterior.'
          schema:
            type: string
        - name: limit
          required: false
          in: query
          schema:
            minimum: 1
            maximum: 100
            default: 50
            type: number
        - name: foldersLimit
          required: false
          in: query
          description: >-
            Carpetas por página ("ver más"). Si se omite, devuelve todas las
            carpetas del nivel.
          schema:
            minimum: 1
            maximum: 100
            type: number
        - name: foldersCursor
          required: false
          in: query
          description: >-
            `foldersNextCursor` opaco de una página anterior. Devuelve solo esa
            página de carpetas, sin herramientas.
          schema:
            type: string
        - name: createdFrom
          required: false
          in: query
          description: Solo herramientas creadas desde esta fecha (ISO 8601).
          schema:
            type: string
            format: date-time
        - name: createdTo
          required: false
          in: query
          description: Solo herramientas creadas hasta esta fecha (ISO 8601).
          schema:
            type: string
            format: date-time
        - name: trackers
          required: false
          in: query
          description: >-
            Chips de trackers como `nombre:valor`, repetibles
            (`?trackers=TRR:00482&trackers=OC:2024`, hasta 10). Una herramienta
            coincide cuando tiene todos: el nombre del tracker se compara exacto
            y el valor de forma parcial y sin distinguir mayúsculas (`482`
            también coincide con `00482`). Como una búsqueda, abarca toda la
            empresa y no lista carpetas. Un chip sin nombre o sin valor responde
            400.
          schema:
            type: array
            items:
              type: string
        - name: folderId
          required: false
          in: query
          description: >-
            Carpeta cuyo contenido directo se lista. Omítela para la raíz. Se
            ignora con `scope=company` o al buscar.
          schema:
            type: string
            format: ObjectId
      responses:
        '200':
          description: Carpetas, herramientas y facetas
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: API key
      type: http
      description: Clave API secreta de la empresa.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.