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

# OneDrive

> Accede y administra archivos, carpetas, usos compartidos y datos de libros de trabajo en OneDrive mediante tu cuenta conectada.

# OneDrive

Usa esta app cuando tu flujo de trabajo necesite encontrar, leer, mover, copiar, compartir o actualizar archivos en OneDrive. También funciona para ediciones de libros de Excel y tareas de listas de SharePoint.

## Configuration

| Option | Required | Description |
| - | - | - |
| Name | No | Etiqueta para el paso en el lienzo del flujo de trabajo. |
| Authentication | Yes | La cuenta conectada de OneDrive que se usará para este paso. |
| Action | Yes | La acción de OneDrive que se realizará (por ejemplo Get Drive Root, Get Item Metadata, Get Item By Path, Search Items). |
| Arguments | Yes | Campos de formulario por acción generados a partir del esquema de la acción. Cada campo de texto tiene un botón **Insert Variable** para insertar valores `{{placeholder}}`. Hay una pestaña **Raw JSON** disponible para uso avanzado. |
| When the step fails | No | Controla si el flujo de trabajo debe **Terminate Workflow** o **Continue** si este paso falla. |

Antes de configurar este paso, conecta OneDrive en **Integrations** para tu espacio de trabajo usando el flujo de inicio de sesión. Si no hay ninguna conexión activa disponible, el paso muestra una advertencia con un enlace a **Integrations** en lugar del selector de cuenta.

## Arguments form

Cuando seleccionas una acción, la sección **Arguments** muestra un formulario impulsado por el esquema de entrada de la acción. Los campos que hacen referencia a registros existentes incluyen selectores desplegables.

Cambia a la pestaña **Raw JSON** cuando prefieras escribir a mano el objeto completo de argumentos. Los cambios en cualquiera de las pestañas se mantienen sincronizados.

## Common actions

| Action | Description |
| - | - |
| **Get Drive Root** | Recupera la carpeta raíz del OneDrive del usuario que inició sesión. |
| **Get Item Metadata** | Recupera los metadatos de un archivo o carpeta por su ID de elemento. |
| **Get Item By Path** | Recupera los metadatos de un archivo o carpeta por su ruta relativa a la unidad. |
| **Search Items** | Busca archivos y carpetas en OneDrive por palabra clave. |
| **List Folder Children** | Enumera los archivos y carpetas que están directamente dentro de una carpeta. |
| **Move Item** | Mueve un archivo o carpeta a una nueva carpeta principal. |
| **Copy Item** | Copia un archivo o carpeta a una nueva ubicación. |
| **Update Item Metadata** | Actualiza los metadatos de un archivo o carpeta. |
| **Update File Content** | Reemplaza el contenido de un archivo existente. |
| **Download File** | Descarga un archivo por su ID de elemento. |
| **Restore Deleted Item** | Restaura un archivo o carpeta eliminado de la papelera de reciclaje. |
| **List Drives** | Enumera las unidades disponibles para la cuenta conectada o para un usuario, grupo o sitio específico. |
| **Get Site Details** | Recupera los metadatos de un sitio de SharePoint por su ID. |
| **List Site Lists** | Enumera todas las listas disponibles en un sitio de SharePoint. |

Las acciones destructivas, como eliminar registros, no están disponibles en el selector de acciones del flujo de trabajo.

## Output

Este paso almacena la respuesta de OneDrive como salida del paso. La estructura de la respuesta depende de la acción.

Usa la referencia completa de salida en pasos posteriores:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## Example

1. Abre **Integrations** y conecta OneDrive si aún no lo has hecho.
2. Añade un paso de **OneDrive** a tu flujo de trabajo.
3. Selecciona una cuenta conectada en **Authentication**.
4. Elige **Get Drive Root** en **Action**.
5. Completa los campos obligatorios. Usa **Insert Variable** para referenciar la salida de un paso anterior en cualquier valor de campo.
6. Haz clic en **Run** en el encabezado del paso para probar la acción y luego revisa la carga útil devuelta en **Output**.

## Use cases

### Share a file link

1. Search Items
2. Get Item Metadata
3. Create Sharing Link

### Update a workbook

1. Create Workbook Session
2. List Worksheets
3. Read Workbook Range
4. Write Workbook Cell

### Track SharePoint data

1. Get Site Details
2. List Site Lists
3. Get List Items
4. Update List Item Fields

## Notes

* Este paso depende de una integración conectada de OneDrive en tu espacio de trabajo.
* El selector de acciones del flujo de trabajo muestra un conjunto seleccionado de acciones. Los agentes con la herramienta de OneDrive pueden usar más de ellas.
* La pantalla de inicio de sesión puede mostrar la marca de autorización de terceros.

## Using OneDrive as an Agent Tool

También puedes agregar OneDrive como herramienta en el **Agent Editor**. Abre el agente, haz clic en **Add tool** y selecciona **OneDrive**. En el panel de configuración de la herramienta, elige la cuenta conectada que el agente debe usar. El agente llama a acciones de OneDrive cuando son relevantes para la conversación.

See also: [Integrations](https://docs.fetchhive.com/es/workspace/integrations.md), [Creating and Editing](https://docs.fetchhive.com/es/workflows/creating-and-editing.md), and [Testing and Iteration](https://docs.fetchhive.com/es/workflows/testing-and-iteration.md)


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