> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/access-control/es/integraciones-y-alertas/manage-doors-via-api/manage-lockdowns-and-scenarios-via-api.md).

# Gestionar escenarios mediante API

Los escenarios pueden administrarse de forma programática a través de la API de Verkada, incluido listar los escenarios disponibles, activar uno o liberar uno activo. [Escenarios de emergencia](/access-control/es/integraciones-y-alertas/configure-access-control-event-alerts/emergency-lockdown.md) son respuestas de emergencia preconfiguradas que los administradores pueden activar para bloquear y desbloquear puertas y notificar a las personas adecuadas cuando ocurre algo, organizadas en cinco tipos: Bloqueo, Retención, Seguridad, Evacuación y Refugio.

***

## Configuración de Command

#### Nivel de organización

{% stepper %}
{% step %}
**En Verkada Command, vaya a Todos los productos > Acceso.**
{% endstep %}

{% step %}
**En la navegación izquierda, haga clic en Configuración de acceso.**
{% endstep %}

{% step %}
**Activa la opción de habilitar el bloqueo y el control de escenarios mediante API.**
{% endstep %}
{% endstepper %}

#### Generar clave API

{% stepper %}
{% step %}
**En Verkada Command, vaya a Todos los productos > Admin.**
{% endstep %}

{% step %}
**En Configuración de la organización, haz clic en API e integraciones.**
{% endstep %}

{% step %}
**En la configuración de API e integraciones, selecciona Claves API > Agregar.**

a. Seleccione **Nueva clave** y haz clic en **Siguiente.**\
b. Ingresa un nombre único.\
c. En **Puntos finales**, selecciona **control de acceso.**\
d. Establece los permisos en **Lectura/escritura**.\
e. Establece la fecha de vencimiento.\
f. Haz clic en **Generar API.**
{% endstep %}
{% endstepper %}

***

## Acciones de API disponibles

Una vez que configures Command para permitir el control de escenarios mediante API, puedes realizar las siguientes acciones:

* [Listar escenarios](https://apidocs.verkada.com/reference/getaccessscenariolistviewv1): Recupera todos los escenarios configurados en toda tu organización.
* [Activar un escenario](https://apidocs.verkada.com/reference/postaccessscenarioactivateviewv1): Activa un escenario de forma programática en respuesta a un evento o una condición.
* [Desactivar un escenario](https://apidocs.verkada.com/reference/postaccessscenarioreleaseviewv1): Finaliza o desactiva un escenario activo.

{% hint style="warning" %}
Consulte [Documentación de la API de Verkada](https://apidocs.verkada.com/reference/access-scenarios) para obtener más detalles sobre puntos finales específicos de la API de control de acceso.
{% endhint %}

***

## Activar y desactivar un escenario mediante API

Cuando un escenario, como un bloqueo, se activa o se desactiva a través de la API, se comporta igual que si se activara manualmente en Command.

Usar la API para activar o desactivar un escenario hará lo siguiente:

* Ejecutará todas las acciones de escenario configuradas, como bloquear puertas, desbloquear puertas, activar alertas o activar salidas AUX.
* Actualizará el estado del escenario tanto en la interfaz de Command como en la aplicación Verkada Pass.
* Generará registros de eventos para cada acción, visibles en el informe de Eventos y en el registro de auditoría de Command.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/access-control/es/integraciones-y-alertas/manage-doors-via-api/manage-lockdowns-and-scenarios-via-api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
