Mettre à jour un workflow personnalisé

curl --request PUT \
  --url https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "Workflow updated by smoke runner"
}
'

import requests

url = "https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}"

payload = { "description": "Workflow updated by smoke runner" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const url = 'https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: 'Workflow updated by smoke runner'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: 'Workflow updated by smoke runner'})
};

fetch('https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_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://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_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([
    'description' => 'Workflow updated by smoke runner'
  ]),
  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;
}

{
  "id": "custom-workflow-1",
  "name": "Exemple MARKO",
  "description": "Workflow updated by smoke runner",
  "type": "example",
  "schedule": "example",
  "enabled": false,
  "custom": false,
  "editable": false,
  "deletable": false,
  "toggleable": false,
  "source": "example",
  "scope": "example",
  "impact": "example",
  "job_types": [],
  "preset_key": null,
  "status": "instruction",
  "schedule_kind": null,
  "schedule_config": {},
  "config": {},
  "last_run_at": null,
  "next_run_at": null,
  "last_error": null
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Authorizations

Authorization

string

header

required

Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.

Headers

X-Request-ID

string

Partner-generated correlation identifier echoed in logs and error payloads.

Path Parameters

definition_id

string

required

Paramètre definition_id pour cette route; type, format et contraintes ci-dessous.

Body

application/json

Schema to update a custom workflow definition.

name

string | null

Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route.

Required string length: 1 - 200

description

string | null

Description libre de la ressource.

Maximum string length: 1000

preset_key

string | null

Clé du preset de workflow; utiliser une valeur du catalogue de presets.

Maximum string length: 80

schedule_kind

string | null

Mode de planification: utiliser une valeur du catalogue de presets.

Maximum string length: 20

schedule_config

Schedule Config · object | null

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

config

Config · object | null

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

enabled

boolean | null

Indique si cette définition est activée.

Response

Successful response

string

required

Clé du workflow, pas nécessairement un UUID.

name

string

required

Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route.

description

string

required

Description libre de la ressource.

type

string

required

Famille de traitement de cette définition de workflow.

schedule

string

required

Planification actuelle du workflow.

enabled

boolean

required

Indique si cette définition est activée.

custom

boolean

required

Indique si le workflow est une définition personnalisée.

editable

boolean

required

Indique si cette définition de workflow peut être modifiée.

deletable

boolean

required

Indique si cette définition de workflow peut être supprimée.

toggleable

boolean

required

Indique si cette définition de workflow peut être activée ou désactivée.

source

string

required

Origine de cette définition de workflow; distingue les workflows système des workflows personnalisés.

scope

string

required

Périmètre métier couvert par le workflow; distinct des scopes d'autorisation de la clé API.

impact

string

required

Indication de l'effet métier attendu du preset.

job_types

string[]

required

Types de traitements associés à cette définition de workflow.

preset_key

string | null

required

Clé du preset de workflow; utiliser une valeur du catalogue de presets.

status

string

required

État de la définition de workflow: draft, active, inactive ou error. Distinct du résultat d'une exécution.

schedule_kind

string | null

required

Mode de planification: utiliser une valeur du catalogue de presets.

schedule_config

object

required

Objet JSON métier; les clés dépendent de la source ou du preset.

config

object

required

Objet JSON métier; les clés dépendent de la source ou du preset.

last_run_at

string<date-time> | null

required

Date de la dernière exécution du workflow.

next_run_at

string<date-time> | null

required

Date de la prochaine exécution planifiée, si elle existe.

last_error

string | null

required

Dernière erreur enregistrée pour cette définition de workflow.

Mettre à jour un workflow personnalisé

curl --request PUT \
  --url https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "Workflow updated by smoke runner"
}
'

import requests

url = "https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}"

payload = { "description": "Workflow updated by smoke runner" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const url = 'https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: 'Workflow updated by smoke runner'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({description: 'Workflow updated by smoke runner'})
};

fetch('https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_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://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_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([
    'description' => 'Workflow updated by smoke runner'
  ]),
  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;
}

{
  "id": "custom-workflow-1",
  "name": "Exemple MARKO",
  "description": "Workflow updated by smoke runner",
  "type": "example",
  "schedule": "example",
  "enabled": false,
  "custom": false,
  "editable": false,
  "deletable": false,
  "toggleable": false,
  "source": "example",
  "scope": "example",
  "impact": "example",
  "job_types": [],
  "preset_key": null,
  "status": "instruction",
  "schedule_kind": null,
  "schedule_config": {},
  "config": {},
  "last_run_at": null,
  "next_run_at": null,
  "last_error": null
}

{
  "type": "about:blank",
  "title": "Unauthorized",
  "status": 401,
  "detail": "A valid bearer token is required.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "The API key does not allow this operation.",
  "request_id": "req_example_partner_call"
}

{
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "type": "about:blank",
  "request_id": "<string>",
  "scope": "<string>",
  "route_id": "<string>",
  "reason_code": "<string>"
}

{
  "type": "about:blank",
  "title": "Unprocessable Content",
  "status": 422,
  "detail": "The request payload or parameters are invalid.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Too Many Requests",
  "status": 429,
  "detail": "The request rate limit was exceeded.",
  "request_id": "req_example_partner_call"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "An unexpected server error occurred.",
  "request_id": "req_example_partner_call"
}

Démarrer

Tutoriels

Intégrer

Référence API

Mettre à jour un workflow personnalisé

Authorizations

Headers

Path Parameters

Body

Response