Workflows et extraction IA
Lancer un workflow maintenant
Déclenche une exécution manuelle d’un workflow personnalisé.
Scope requis : workflows:write. Scopes et délégation.
Idempotence : header Idempotency-Key obligatoire. Pour reprendre la même mutation, réutiliser la même clé et le même contenu. Écritures et idempotence.
Lancer un workflow maintenant
curl --request POST \
--url https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const url = 'https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run';
const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch('https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run', 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}/run",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"workflow": {
"id": "custom-workflow-1",
"name": "Exemple MARKO",
"description": "example",
"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
},
"run": {
"id": "11111111-1111-4111-8111-111111111111",
"workflow_id": "example",
"workflow_name": null,
"workflow_source": "custom",
"job_type": null,
"preset_key": null,
"status": "queued",
"entity_type": null,
"entity_id": null,
"retry_count": 0,
"error_message": null,
"result": {},
"created_at": null,
"started_at": null,
"completed_at": null,
"trigger_mode": "example"
}
}{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "Idempotency-Key must contain at most 255 visible ASCII characters without spaces.",
"request_id": "req_example_partner_call"
}{
"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": "Conflict",
"status": 409,
"detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
"request_id": "req_example_partner_call"
}{
"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": "Precondition Required",
"status": 428,
"detail": "The Idempotency-Key header is required.",
"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
Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.
Headers
Partner-generated correlation identifier echoed in logs and error payloads.
Required for every write, including environments where replay deduplication is disabled. Reuse the same value when retrying the same logical write and use a new value for a different write.
Maximum string length:
255Pattern:
^[!-~]+$Path Parameters
Paramètre definition_id pour cette route; type, format et contraintes ci-dessous.
⌘I
Lancer un workflow maintenant
curl --request POST \
--url https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run \
--header 'Authorization: Bearer <token>' \
--header 'Idempotency-Key: <idempotency-key>'import requests
url = "https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run"
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>"
}
response = requests.post(url, headers=headers)
print(response.text)const url = 'https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run';
const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));const options = {
method: 'POST',
headers: {'Idempotency-Key': '<idempotency-key>', Authorization: 'Bearer <token>'}
};
fetch('https://partner-api.marko.fr/v1/workflows/workflow-definitions/{definition_id}/run', 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}/run",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"workflow": {
"id": "custom-workflow-1",
"name": "Exemple MARKO",
"description": "example",
"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
},
"run": {
"id": "11111111-1111-4111-8111-111111111111",
"workflow_id": "example",
"workflow_name": null,
"workflow_source": "custom",
"job_type": null,
"preset_key": null,
"status": "queued",
"entity_type": null,
"entity_id": null,
"retry_count": 0,
"error_message": null,
"result": {},
"created_at": null,
"started_at": null,
"completed_at": null,
"trigger_mode": "example"
}
}{
"type": "about:blank",
"title": "Bad Request",
"status": 400,
"detail": "Idempotency-Key must contain at most 255 visible ASCII characters without spaces.",
"request_id": "req_example_partner_call"
}{
"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": "Conflict",
"status": 409,
"detail": "The idempotency key payload, external reference, target, or source conflicts with an existing write.",
"request_id": "req_example_partner_call"
}{
"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": "Precondition Required",
"status": 428,
"detail": "The Idempotency-Key header is required.",
"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"
}