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

# Descripción general de la API v1 (Legacy)

> Gestión básica de sesiones y automatización con acceso limitado al ámbito de la organización

<Warning>
  Esta versión de la API está descontinuada. Utiliza [API v3](/es/api-reference/v3/overview) con autenticación de usuario de servicio. Consulta la [guía de migración](/es/api-reference/getting-started/migration-guide) para obtener instrucciones paso a paso.
</Warning>

La API v1 proporciona la funcionalidad básica para crear y gestionar sesiones de Devin, junto con recursos auxiliares como secretos, conocimiento y playbooks.

**URL base:** `https://api.devin.ai/v1/*`

**Autenticación:** claves de API personales o de servicio ([más información](/es/api-reference/authentication))

<div id="permissions">
  ## Permisos
</div>

La API v1 usa autenticación con ámbito de organización. Las API keys están asociadas a un par específico `(org_id, user_id)` y proporcionan acceso a los recursos dentro de esa organización. La API v1 no utiliza el sistema completo de permisos RBAC: el acceso se determina en función del ámbito de organización de la API key.

Para un control RBAC más detallado, utiliza la [Organization API](/es/api-reference/v3/overview).

<div id="sessions">
  ## Sesiones
</div>

Gestiona las sesiones de Devin e interactúa con ellas:

<CardGroup cols={2}>
  <Card title="Listar sesiones" icon="list" href="/es/api-reference/v1/sessions/list-sessions">
    Lista todas las sesiones actuales de Devin de tu organización
  </Card>

  <Card title="Crear una sesión" icon="plus" href="/es/api-reference/v1/sessions/create-a-new-devin-session">
    Inicia una nueva sesión de Devin con una descripción de la tarea y parámetros opcionales
  </Card>

  <Card title="Obtener detalles de la sesión" icon="circle-info" href="/es/api-reference/v1/sessions/retrieve-details-about-an-existing-session">
    Obtén información sobre el estado y el resultado de una sesión existente
  </Card>

  <Card title="Enviar mensaje" icon="message" href="/es/api-reference/v1/sessions/send-a-message-to-an-existing-devin-session">
    Interactúa con una sesión activa enviando mensajes a Devin
  </Card>

  <Card title="Subir archivos" icon="upload" href="/es/api-reference/v1/attachments/upload-files-for-devin-to-work-with">
    Sube archivos para que Devin trabaje con ellos durante las sesiones
  </Card>

  <Card title="Actualizar etiquetas de la sesión" icon="tags" href="/es/api-reference/v1/sessions/update-session-tags">
    Actualiza las etiquetas asociadas a una sesión de Devin
  </Card>
</CardGroup>

<div id="secrets">
  ## Secretos
</div>

Gestiona los secretos y credenciales de tu organización:

<CardGroup cols={2}>
  <Card title="List Secrets" icon="key" href="/es/api-reference/v1/secrets/list-secrets">
    Consulta los metadatos de todos los secretos de tu organización
  </Card>

  <Card title="Delete Secret" icon="trash" href="/es/api-reference/v1/secrets/delete-secret">
    Elimina de forma permanente un secreto de tu organización
  </Card>
</CardGroup>

<div id="knowledge">
  ## Knowledge
</div>

Gestiona Knowledge para tu organización:

<CardGroup cols={2}>
  <Card title="List Knowledge" icon="list" href="/es/api-reference/v1/knowledge/list-knowledge">
    Enumera todo el Knowledge y las carpetas de tu organización
  </Card>

  <Card title="Create Knowledge" icon="plus" href="/es/api-reference/v1/knowledge/create-knowledge">
    Crea un nuevo elemento de Knowledge
  </Card>

  <Card title="Update Knowledge" icon="pencil" href="/es/api-reference/v1/knowledge/update-knowledge">
    Actualiza un elemento de Knowledge
  </Card>

  <Card title="Delete Knowledge" icon="trash" href="/es/api-reference/v1/knowledge/delete-knowledge">
    Elimina un elemento de Knowledge
  </Card>
</CardGroup>

<div id="playbooks">
  ## Playbooks
</div>

Administra conjuntos de instrucciones reutilizables para tu organización:

<CardGroup cols={2}>
  <Card title="Listar Playbooks" icon="list" href="/es/api-reference/v1/playbooks/list-playbooks">
    Consulta todos los playbooks disponibles para tu organización
  </Card>

  <Card title="Crear Playbook" icon="plus" href="/es/api-reference/v1/playbooks/create-playbook">
    Crea un nuevo playbook de equipo con instrucciones y una macro opcional
  </Card>

  <Card title="Obtener Playbook" icon="circle-info" href="/es/api-reference/v1/playbooks/get-playbook">
    Recupera los detalles de un playbook específico
  </Card>

  <Card title="Actualizar Playbook" icon="pencil" href="/es/api-reference/v1/playbooks/update-playbook">
    Actualiza un playbook de equipo existente
  </Card>

  <Card title="Eliminar Playbook" icon="trash" href="/es/api-reference/v1/playbooks/delete-playbook">
    Elimina un playbook de equipo de tu organización
  </Card>
</CardGroup>

<div id="next-steps">
  ## Próximos pasos
</div>

Realiza la migración a la [API actual](/es/api-reference/overview) para RBAC, atribución de sesiones y nuevas funcionalidades. Consulta la [guía de migración](/es/api-reference/getting-started/migration-guide).