Skip to main content
POST
Crear un flujo

Autorizaciones

Authorization
string
header
requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Encabezados

Accept-Language
enum<string>
predeterminado:es-ES

Código de idioma para campos de texto que admiten varios idiomas. Al crear o actualizar recursos, esto especifica el idioma de los valores de texto proporcionados. Al recuperar recursos, esto determina qué variante de idioma de los campos de texto multilingües se devuelve. Valores aceptados: 'en-EN' (inglés), 'es-ES' (español), 'pt-BR' (portugués), 'ca-ES' (catalán), 'eu-ES' (euskera). El valor predeterminado es 'es-ES' si no se proporciona.

Opciones disponibles:
en-EN,
es-ES,
pt-BR,
ca-ES,
eu-ES

Parámetros de ruta

organization_id
string
requerido

El identificador único de la organización

Maximum string length: 24
Pattern: ^[0-9a-f]{24}$

Cuerpo

application/json
name
object
requerido

Nombre del flujo. Se requiere al menos una clave de idioma; cada valor debe tener entre 1 y 512 caracteres.

description
object
requerido

Descripción del flujo. Se requiere al menos una clave de idioma; cada valor debe tener entre 1 y 512 caracteres.

type
enum<string>
requerido
Opciones disponibles:
session,
workspace
detection_only
boolean
requerido
cooldown_minutes
number
requerido

Tiempo de espera en minutos. Debe estar entre 10 y 1440.

Rango requerido: 10 <= x <= 1440
target
object
requerido
microservice_id
string
requerido
Maximum string length: 24
Pattern: ^[0-9a-f]{24}$
conditions
object[]
requerido
enabled
boolean
predeterminado:false

Si es true, el flujo queda habilitado tras su creación (requiere condiciones, microservicio y objetivo válidos). Si se omite o es false, se crea un flujo deshabilitado.

init_text
object

Mensaje de texto inicial. Se omite si no es necesario. Cuando se proporciona, se requiere al menos una clave de idioma; cada valor debe tener entre 1 y 512 caracteres.

ok_text
object

Mensaje de texto de éxito. Se omite si no es necesario. Cuando se proporciona, se requiere al menos una clave de idioma; cada valor debe tener entre 1 y 512 caracteres.

ko_text
object

Mensaje de texto de error. Se omite si no es necesario. Cuando se proporciona, se requiere al menos una clave de idioma; cada valor debe tener entre 1 y 512 caracteres.

Respuesta

Flujo creado correctamente. La respuesta contiene el recurso creado.

Detalle del flujo tal como lo devuelve GET flow by id. La organización está implícita por la ruta /v2/organizations/{organization_id}/flows/{flow_id}. Los workspaces/grupos de destino se normalizan en target.ids (cadenas hexadecimales de ObjectId de MongoDB).

id
string
requerido
Maximum string length: 24
Pattern: ^[0-9a-f]{24}$
created_at
string<date-time>
requerido
name
string
requerido

Resuelto para Accept-Language cuando es multilingüe

description
string
requerido

Resuelto para Accept-Language cuando es multilingüe

type
enum<string>
requerido
Opciones disponibles:
session,
workspace
version
number
requerido
detection_only
boolean
requerido
cooldown_minutes
number
requerido

Tiempo de espera en minutos

enabled
boolean
requerido
target
object
requerido

Destino de ejecución: type selecciona el alcance; ids enumera valores de _id de Workspace, _id de grupo de Workspace o _id de Grupo de reporte (vacío cuando type es ALL_WORKSPACES)

conditions
object[]

Omitido o vacío cuando el flujo no tiene condiciones

trigger
string | null
microservice_id
string | null

ID del microservicio vinculado cuando está presente

init_text
string | null

Resuelto para Accept-Language cuando es multilingüe

ok_text
string | null

Resuelto para Accept-Language cuando es multilingüe

ko_text
string | null

Resuelto para Accept-Language cuando es multilingüe

execution_metrics
object | null

Presente cuando se calcularon métricas para este flujo