Pular para o conteúdo principal
PUT
/
v1
/
organizations
/
{organization_id}
/
flows
/
{flow_id}
Atualizar um fluxo
curl --request PUT \
  --url https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": {
    "en-EN": "Flujo diario de copia actualizado",
    "es-ES": "Proceso de copia diaria actualizado"
  },
  "description": {
    "en-EN": "Proceso automatizado de copia diaria actualizado",
    "es-ES": "Proceso automatizado de copia actualizado"
  },
  "detection_only": false,
  "cooldown_minutes": 120,
  "enabled": true,
  "init_text": {
    "en-EN": "Iniciando proceso de copia actualizado...",
    "es-ES": "Iniciando proceso de copia actualizado..."
  },
  "ok_text": {
    "en-EN": "Copia completada correctamente"
  },
  "ko_text": {
    "en-EN": "La copia fallo. Por favor, revisa los registros."
  },
  "target": {
    "type": "workspaces",
    "ids": [
      "507f1f77bcf86cd799439012",
      "507f1f77bcf86cd799439013"
    ]
  },
  "microservice_id": "507f1f77bcf86cd799439014",
  "conditions": [
    {
      "condition_type_id": "507f1f77bcf86cd799439015",
      "operator": "gte",
      "compare_to": "90",
      "period": null,
      "check_every": 600
    }
  ]
}
'
import requests

url = "https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id}"

payload = {
"name": {
"en-EN": "Flujo diario de copia actualizado",
"es-ES": "Proceso de copia diaria actualizado"
},
"description": {
"en-EN": "Proceso automatizado de copia diaria actualizado",
"es-ES": "Proceso automatizado de copia actualizado"
},
"detection_only": False,
"cooldown_minutes": 120,
"enabled": True,
"init_text": {
"en-EN": "Iniciando proceso de copia actualizado...",
"es-ES": "Iniciando proceso de copia actualizado..."
},
"ok_text": { "en-EN": "Copia completada correctamente" },
"ko_text": { "en-EN": "La copia fallo. Por favor, revisa los registros." },
"target": {
"type": "workspaces",
"ids": ["507f1f77bcf86cd799439012", "507f1f77bcf86cd799439013"]
},
"microservice_id": "507f1f77bcf86cd799439014",
"conditions": [
{
"condition_type_id": "507f1f77bcf86cd799439015",
"operator": "gte",
"compare_to": "90",
"period": None,
"check_every": 600
}
]
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: {
'en-EN': 'Flujo diario de copia actualizado',
'es-ES': 'Proceso de copia diaria actualizado'
},
description: {
'en-EN': 'Proceso automatizado de copia diaria actualizado',
'es-ES': 'Proceso automatizado de copia actualizado'
},
detection_only: false,
cooldown_minutes: 120,
enabled: true,
init_text: {
'en-EN': 'Iniciando proceso de copia actualizado...',
'es-ES': 'Iniciando proceso de copia actualizado...'
},
ok_text: {'en-EN': 'Copia completada correctamente'},
ko_text: {'en-EN': 'La copia fallo. Por favor, revisa los registros.'},
target: {
type: 'workspaces',
ids: ['507f1f77bcf86cd799439012', '507f1f77bcf86cd799439013']
},
microservice_id: '507f1f77bcf86cd799439014',
conditions: [
{
condition_type_id: '507f1f77bcf86cd799439015',
operator: 'gte',
compare_to: '90',
period: null,
check_every: 600
}
]
})
};

fetch('https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'name' => [
'en-EN' => 'Flujo diario de copia actualizado',
'es-ES' => 'Proceso de copia diaria actualizado'
],
'description' => [
'en-EN' => 'Proceso automatizado de copia diaria actualizado',
'es-ES' => 'Proceso automatizado de copia actualizado'
],
'detection_only' => false,
'cooldown_minutes' => 120,
'enabled' => true,
'init_text' => [
'en-EN' => 'Iniciando proceso de copia actualizado...',
'es-ES' => 'Iniciando proceso de copia actualizado...'
],
'ok_text' => [
'en-EN' => 'Copia completada correctamente'
],
'ko_text' => [
'en-EN' => 'La copia fallo. Por favor, revisa los registros.'
],
'target' => [
'type' => 'workspaces',
'ids' => [
'507f1f77bcf86cd799439012',
'507f1f77bcf86cd799439013'
]
],
'microservice_id' => '507f1f77bcf86cd799439014',
'conditions' => [
[
'condition_type_id' => '507f1f77bcf86cd799439015',
'operator' => 'gte',
'compare_to' => '90',
'period' => null,
'check_every' => 600
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id}"

payload := strings.NewReader("{\n \"name\": {\n \"en-EN\": \"Flujo diario de copia actualizado\",\n \"es-ES\": \"Proceso de copia diaria actualizado\"\n },\n \"description\": {\n \"en-EN\": \"Proceso automatizado de copia diaria actualizado\",\n \"es-ES\": \"Proceso automatizado de copia actualizado\"\n },\n \"detection_only\": false,\n \"cooldown_minutes\": 120,\n \"enabled\": true,\n \"init_text\": {\n \"en-EN\": \"Iniciando proceso de copia actualizado...\",\n \"es-ES\": \"Iniciando proceso de copia actualizado...\"\n },\n \"ok_text\": {\n \"en-EN\": \"Copia completada correctamente\"\n },\n \"ko_text\": {\n \"en-EN\": \"La copia fallo. Por favor, revisa los registros.\"\n },\n \"target\": {\n \"type\": \"workspaces\",\n \"ids\": [\n \"507f1f77bcf86cd799439012\",\n \"507f1f77bcf86cd799439013\"\n ]\n },\n \"microservice_id\": \"507f1f77bcf86cd799439014\",\n \"conditions\": [\n {\n \"condition_type_id\": \"507f1f77bcf86cd799439015\",\n \"operator\": \"gte\",\n \"compare_to\": \"90\",\n \"period\": null,\n \"check_every\": 600\n }\n ]\n}")

req, _ := http.NewRequest("PUT", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.put("https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id}")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"name\": {\n \"en-EN\": \"Flujo diario de copia actualizado\",\n \"es-ES\": \"Proceso de copia diaria actualizado\"\n },\n \"description\": {\n \"en-EN\": \"Proceso automatizado de copia diaria actualizado\",\n \"es-ES\": \"Proceso automatizado de copia actualizado\"\n },\n \"detection_only\": false,\n \"cooldown_minutes\": 120,\n \"enabled\": true,\n \"init_text\": {\n \"en-EN\": \"Iniciando proceso de copia actualizado...\",\n \"es-ES\": \"Iniciando proceso de copia actualizado...\"\n },\n \"ok_text\": {\n \"en-EN\": \"Copia completada correctamente\"\n },\n \"ko_text\": {\n \"en-EN\": \"La copia fallo. Por favor, revisa los registros.\"\n },\n \"target\": {\n \"type\": \"workspaces\",\n \"ids\": [\n \"507f1f77bcf86cd799439012\",\n \"507f1f77bcf86cd799439013\"\n ]\n },\n \"microservice_id\": \"507f1f77bcf86cd799439014\",\n \"conditions\": [\n {\n \"condition_type_id\": \"507f1f77bcf86cd799439015\",\n \"operator\": \"gte\",\n \"compare_to\": \"90\",\n \"period\": null,\n \"check_every\": 600\n }\n ]\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.flexxible.net/v1/organizations/{organization_id}/flows/{flow_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"name\": {\n \"en-EN\": \"Flujo diario de copia actualizado\",\n \"es-ES\": \"Proceso de copia diaria actualizado\"\n },\n \"description\": {\n \"en-EN\": \"Proceso automatizado de copia diaria actualizado\",\n \"es-ES\": \"Proceso automatizado de copia actualizado\"\n },\n \"detection_only\": false,\n \"cooldown_minutes\": 120,\n \"enabled\": true,\n \"init_text\": {\n \"en-EN\": \"Iniciando proceso de copia actualizado...\",\n \"es-ES\": \"Iniciando proceso de copia actualizado...\"\n },\n \"ok_text\": {\n \"en-EN\": \"Copia completada correctamente\"\n },\n \"ko_text\": {\n \"en-EN\": \"La copia fallo. Por favor, revisa los registros.\"\n },\n \"target\": {\n \"type\": \"workspaces\",\n \"ids\": [\n \"507f1f77bcf86cd799439012\",\n \"507f1f77bcf86cd799439013\"\n ]\n },\n \"microservice_id\": \"507f1f77bcf86cd799439014\",\n \"conditions\": [\n {\n \"condition_type_id\": \"507f1f77bcf86cd799439015\",\n \"operator\": \"gte\",\n \"compare_to\": \"90\",\n \"period\": null,\n \"check_every\": 600\n }\n ]\n}"

response = http.request(request)
puts response.read_body
{
  "id": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "description": "<string>",
  "version": 123,
  "detection_only": true,
  "cooldown_minutes": 123,
  "enabled": true,
  "target": {
    "ids": [
      "<string>"
    ]
  },
  "conditions": [
    {
      "condition_type_id": "<string>",
      "metric": "<string>",
      "operator": "<string>",
      "compare_to": "<string>",
      "check_every": 123,
      "period": 123
    }
  ],
  "trigger": "<string>",
  "microservice_id": "<string>",
  "init_text": "<string>",
  "ok_text": "<string>",
  "ko_text": "<string>",
  "execution_metrics": {
    "targeted_workspaces": 123,
    "evaluations_per_day": 123,
    "possible_executions_per_day": 123,
    "total_possible_executions_per_day": 123
  }
}
{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}
{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}
{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}
{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}
{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}
{
"error": {
"message": "<string>",
"code": "<string>",
"details": "<string>"
}
}

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Accept-Language
enum<string>
padrão:es-ES

Código de idioma para campos de texto que suportam vários idiomas. Ao criar ou atualizar recursos, isso especifica o idioma dos valores de texto fornecidos. Ao recuperar recursos, isso determina qual variante de idioma dos campos de texto multilíngues será retornada. Valores aceitos: 'en-EN' (inglês), 'es-ES' (espanhol), 'pt-BR' (português), 'ca-ES' (catalão), 'eu-ES' (basco). O valor padrão é 'es-ES' se não for fornecido.

Opções disponíveis:
en-EN,
es-ES,
pt-BR,
ca-ES,
eu-ES

Parâmetros de caminho

organization_id
string
obrigatório

O identificador único da organização

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

O identificador único do fluxo a ser atualizado

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

Corpo

application/json
name
object
obrigatório

Nome do fluxo. É necessário pelo menos uma chave de idioma; cada valor entre 1 e 512 caracteres.

description
object
obrigatório

Descrição do fluxo. Pelo menos uma chave de idioma é necessário; cada valor entre 1 e 512 caracteres.

detection_only
boolean
obrigatório
cooldown_minutes
number
obrigatório

Tempo de espera em minutos. Deve estar entre 10 e 1440.

Intervalo obrigatório: 10 <= x <= 1440
enabled
boolean
obrigatório

Indica se o fluxo está habilitado. PUT espera uma definição completa; este campo é obrigatório.

init_text
object | null
obrigatório

Mensagem de texto inicial. Obrigatório em PUT. Enviar null para limpar; caso contrário, objeto com pelo menos uma chave de idioma; cada valor entre 1 e 512 caracteres.

ok_text
object | null
obrigatório

Mensagem de texto de sucesso. Obrigatório no PUT. Envia null para limpar; caso contrário, objeto com pelo menos uma chave de idioma; cada valor entre 1 e 512 caracteres.

ko_text
object | null
obrigatório

Mensagem de texto de erro. Obrigatório em PUT. Enviar null para limpar; caso contrário, objeto com pelo menos uma chave de idioma; cada valor entre 1 e 512 caracteres.

target
object
obrigatório
microservice_id
string
obrigatório
Maximum string length: 24
Pattern: ^[0-9a-f]{24}$
conditions
object[]
obrigatório

Resposta

Fluxo atualizado corretamente. A resposta contém o recurso atualizado.

Detalhe do fluxo como retornado por GET flow por id. A organização é implícita pelo caminho /v1/organizations/{organization_id}/flows/{flow_id}. Os workspaces/grupos alvo são normalizados em target.ids (cadenas hexadecimais de ObjectId de MongoDB).

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

Resolvido para Accept-Language quando é multilíngue

description
string
obrigatório

Resolvido para Accept-Language quando é multilíngue

type
enum<string>
obrigatório
Opções disponíveis:
session,
workspace
version
number
obrigatório
detection_only
boolean
obrigatório
cooldown_minutes
number
obrigatório

Tempo de espera em minutos

enabled
boolean
obrigatório
target
object
obrigatório

Destino de execução: type seleciona o escopo; ids lista valores de _id de Workspace, _id de grupo de Workspace ou _id de Grupo de relatório (vazio quando type é ALL_WORKSPACES)

conditions
object[]

Omitido ou vazio quando o fluxo não tem condições

trigger
string | null
microservice_id
string | null

ID do microserviço vinculado quando presente

init_text
string | null

Resolvido para Accept-Language quando é multilíngue

ok_text
string | null

Resolvido para Accept-Language quando é multilíngue

ko_text
string | null

Resolvido para Accept-Language quando é multilíngue

execution_metrics
object | null

Presente quando métricas foram calculadas para este fluxo