> ## Documentation Index > Fetch the complete documentation index at: https://docs.bevits.com/llms.txt > Use this file to discover all available pages before exploring further. # Activar flow > Activa un flow revisado, que empieza a enviar mensajes reales. Requiere la revision que revisó la persona; si el flow cambió después, la llamada falla con 409 e informa la revisión actual. Hace las mismas verificaciones que el botón Activar del editor. Requiere una clave API con el permiso write. ## OpenAPI ````yaml /openapi.es.json post /v1/flows/{flow_id}/activate openapi: 3.1.0 info: title: API de Bevits version: 1.0.0 description: >- API pública para consultar datos de CRM, compras y automatización de una organización de Bevits y crear automatizaciones como borrador para revisarlas y activarlas. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://api.bevits.com description: Producción security: - bearerAuth: [] tags: - name: Sistema description: Disponibilidad de la API. - name: Identidad description: Identidad de la organización y de la clave API. - name: Clientes description: Clientes y sus relaciones. - name: Segmentos description: Segmentos de clientes. - name: Compras description: Compras importadas desde las integraciones. - name: Datos del CRM description: Etiquetas y definiciones de atributos. - name: Automatizaciones description: Flows de automatización. - name: Campañas description: Campañas de email. paths: /v1/flows/{flow_id}/activate: post: tags: - Automatizaciones summary: Activar flow description: >- Activa un flow revisado, que empieza a enviar mensajes reales. Requiere la revision que revisó la persona; si el flow cambió después, la llamada falla con 409 e informa la revisión actual. Hace las mismas verificaciones que el botón Activar del editor. Requiere una clave API con el permiso write. operationId: activateFlow parameters: - $ref: '#/components/parameters/FlowId' - $ref: '#/components/parameters/IdempotencyKey' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ActivateFlowRequest' example: revision: rev_3f9a1c2b7d4e responses: '200': $ref: '#/components/responses/Flow' '400': $ref: '#/components/responses/InvalidBody' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/WriteScopeRequired' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/RevisionConflict' '422': $ref: '#/components/responses/FlowValidationError' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' components: parameters: FlowId: name: flow_id in: path required: true description: ID público del flow. schema: type: string pattern: ^flw_[A-Za-z0-9_-]+$ IdempotencyKey: name: Idempotency-Key in: header description: >- Clave única de la operación. Repetir la misma clave con el mismo cuerpo devuelve la respuesta original en lugar de ejecutarla de nuevo. schema: type: string schemas: ActivateFlowRequest: type: object required: - revision properties: revision: type: string pattern: ^rev_[0-9a-f]+$ description: >- La revisión que revisó la persona, devuelta al crear el borrador o al consultar el flow. Flow: type: object required: - object - id - status - created_at - updated_at - html_url properties: object: type: string const: flow id: type: string pattern: ^flw_[A-Za-z0-9_-]+$ name: type: string description: type: string status: type: string trigger_event_type: type: string origin: type: string run_count: deprecated: true description: >- Campo heredado obsoleto, conservado por compatibilidad. Cuando está presente, siempre devuelve 0; no representa el número real de ejecuciones. type: integer minimum: 0 created_at: type: string format: date-time updated_at: type: string format: date-time html_url: type: string format: uri revision: type: string description: >- Identifica el contenido actual del flow (bloques y conexiones). Envíala al activar el flow para que solo el contenido revisado quede activo. ErrorResponse: type: object required: - error properties: error: $ref: '#/components/schemas/Error' RateLimitErrorResponse: allOf: - $ref: '#/components/schemas/ErrorResponse' - type: object required: - retry_after properties: retry_after: type: integer minimum: 1 description: Segundos antes de volver a intentarlo. Error: type: object required: - type - message - request_id properties: type: type: string enum: - authentication_error - conflict - internal_error - invalid_request - not_found - permission_denied - rate_limited - validation_error message: type: string param: type: string request_id: type: string pattern: ^req_[a-f0-9]{24}$ responses: Flow: description: Flow encontrado. headers: ETag: $ref: '#/components/headers/ETag' content: application/json: schema: $ref: '#/components/schemas/Flow' InvalidBody: description: >- Cuerpo de la solicitud ausente, que no es un objeto JSON, o parámetro de ruta inválido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: Clave API ausente, inválida, expirada o revocada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: authentication_error message: Invalid API key. request_id: req_07f6cdc3c20249d6afcd90b4 WriteScopeRequired: description: La clave API no tiene el permiso write. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: permission_denied message: This API key does not have the required "write" scope. param: scope request_id: req_07f6cdc3c20249d6afcd90b4 NotFound: description: El recurso no existe o pertenece a otra organización. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RevisionConflict: description: >- El flow cambió después de la revision indicada. El mensaje incluye la revisión actual; pide una nueva revisión antes de activar. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: type: conflict message: >- The flow changed after revision rev_3f9a1c2b7d4e; its current revision is rev_9b2e7c1a5f30. param: revision request_id: req_07f6cdc3c20249d6afcd90b4 FlowValidationError: description: >- El flow no se puede crear ni activar. El mensaje lista todos los problemas, cada uno con su ruta, la clave del bloque y las opciones válidas. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' RateLimited: description: Límite de solicitudes superado. headers: Retry-After: $ref: '#/components/headers/RetryAfter' X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' InternalError: description: Error inesperado en el servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: ETag: description: Identificador de la versión del contenido para caché condicional. schema: type: string example: '"v1-4ad31f5efb6b8f35"' RetryAfter: description: Segundos antes de volver a intentarlo. schema: type: integer minimum: 1 RateLimitLimit: description: Límite total de la ventana actual. schema: type: integer example: 600 RateLimitRemaining: description: Solicitudes restantes en la ventana actual. schema: type: integer example: 599 RateLimitReset: description: Instante UTC en que termina la ventana actual. schema: type: string format: date-time securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: bvt_live_... description: Clave API creada en la configuración de la organización. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.