Créer une tâche

curl --request POST \
  --url https://partner-api.marko.fr/v1/operations/{operation_id}/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "titre": "Relancer opérateur",
  "statut": "todo"
}
'

import requests

url = "https://partner-api.marko.fr/v1/operations/{operation_id}/tasks"

payload = {
    "titre": "Relancer opérateur",
    "statut": "todo"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const url = 'https://partner-api.marko.fr/v1/operations/{operation_id}/tasks';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({titre: 'Relancer opérateur', statut: 'todo'})
};

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>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({titre: 'Relancer opérateur', statut: 'todo'})
};

fetch('https://partner-api.marko.fr/v1/operations/{operation_id}/tasks', 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/operations/{operation_id}/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'titre' => 'Relancer opérateur',
    'statut' => 'todo'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

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

curl_close($curl);

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

{
  "id": "11111111-aaaa-bbbb-cccc-222222222223",
  "target_type": "operation",
  "target_name": "example",
  "target_url": "example",
  "titre": "Relancer opérateur",
  "statut": "example",
  "categorie": "example",
  "sort_order": 0
}

{
  "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"
}

{
  "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

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.

Idempotency-Key

string

required

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: 255

Pattern: ^[!-~]+$

Path Parameters

operation_id

string<uuid>

required

UUID MARKO de l'opération.

Body

application/json

titre

string

required

Titre de la tâche Kanban.

Required string length: 1 - 500

description

string | null

Description libre de la ressource.

Maximum string length: 2000

statut

string | null

Statut de la tâche Kanban.

Required string length: 1 - 50

categorie

string

default:custom

Catégorie de la tâche Kanban, distincte de sa priorité et de son statut.

Required string length: 1 - 50

priority

enum<string>

default:moyenne

Priorité de la tâche: critique, haute, moyenne ou basse.

Available options:

critique,

haute,

moyenne,

basse

phase_key

string | null

Clé de phase métier à laquelle la tâche est rattachée.

Required string length: 1 - 50

due_date

string<date> | null

Date d'échéance de la tâche, au format YYYY-MM-DD.

assignee_id

string | null

Identifiant utilisateur du responsable de la tâche; ce champ n'est pas nécessairement un UUID.

Required string length: 1 - 255

label_ids

string<uuid>[]

UUID des labels à associer à la tâche.

client_request_id

string | null

Optional durable request id scoped to the operation: retrying the same create replays the already-created task instead of duplicating it.

Pattern: ^[A-Za-z0-9._-]{1,80}$

Response

Successful response

string<uuid>

required

Identifiant MARKO de la ressource.

target_type

enum<string>

required

Type de ressource à laquelle la tâche se rapporte.

Available options:

operation,

operateur,

fond,

spv

target_name

string

required

Nom de la ressource à laquelle la tâche se rapporte.

target_url

string

required

Lien vers la ressource concernée dans l'interface MARKO.

titre

string

required

Titre de la tâche Kanban.

statut

string

required

Statut de la tâche Kanban.

categorie

string

required

Catégorie de la tâche Kanban, distincte de sa priorité et de son statut.

sort_order

integer

required

Position de la tâche dans le board de son opération.

operation_id

string<uuid> | null

UUID MARKO de l'opération.

operateur_id

string<uuid> | null

UUID MARKO de l'opérateur.

fond_id

string<uuid> | null

UUID MARKO du fonds.

spv_id

string<uuid> | null

UUID MARKO de la SPV.

phase_key

string | null

Clé de phase métier à laquelle la tâche est rattachée.

operation_name

string | null

Nom de l'opération concernée.

operation_url

string | null

Lien vers la fiche de l'opération dans MARKO.

operation_piloting_url

string | null

Lien vers le pilotage de l'opération dans MARKO.

fond_name

string | null

Nom du fonds associé à la ressource.

spv_name

string | null

Nom de la SPV associée à la ressource.

responsable_interne

string | null

Responsable interne associé à la ressource.

operateur_nom

string | null

Nom de l'opérateur associé à la cible de la tâche.

asset_manager_nom

string | null

Nom de l'asset manager associé à la cible de la tâche.

statut_interne

string | null

Code de statut interne de l'opération; consulter la dimension internal_status de GET /taxonomies.

statut_operationnel

string[] | null

Codes de statuts opérationnels de l'opération; consulter la dimension operational_status de GET /taxonomies.

description

string | null

Description libre de la ressource.

priority

enum<string>

default:moyenne

Priorité de la tâche: critique, haute, moyenne ou basse.

Available options:

critique,

haute,

moyenne,

basse

assignee_id

string | null

Identifiant utilisateur du responsable de la tâche; ce champ n'est pas nécessairement un UUID.

due_date

string<date> | null

Date d'échéance de la tâche, au format YYYY-MM-DD.

completed_at

string<date-time> | null

Date de fin, lorsqu'une exécution ou un traitement est terminé.

dashboard_sort_order

integer

default:0

Position de la tâche dans le board consolidé.

archived_at

string<date-time> | null

Date d'archivage de la tâche; null si elle n'est pas archivée.

labels

KanbanLabelResponse · object[]

Labels actuellement associés à la tâche.

Show child attributes

created_at

string<date-time> | null

Date de création au format ISO 8601.

updated_at

string<date-time> | null

Date de dernière modification au format ISO 8601.

idempotency_receipt

ManualCreationIdempotencyReceipt · object | null

Reçu de création manuelle indiquant notamment si une création précédente a été rejouée.

Show child attributes

Créer une tâche

curl --request POST \
  --url https://partner-api.marko.fr/v1/operations/{operation_id}/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "titre": "Relancer opérateur",
  "statut": "todo"
}
'

import requests

url = "https://partner-api.marko.fr/v1/operations/{operation_id}/tasks"

payload = {
    "titre": "Relancer opérateur",
    "statut": "todo"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

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

print(response.text)

const url = 'https://partner-api.marko.fr/v1/operations/{operation_id}/tasks';
const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({titre: 'Relancer opérateur', statut: 'todo'})
};

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>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({titre: 'Relancer opérateur', statut: 'todo'})
};

fetch('https://partner-api.marko.fr/v1/operations/{operation_id}/tasks', 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/operations/{operation_id}/tasks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'titre' => 'Relancer opérateur',
    'statut' => 'todo'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

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

curl_close($curl);

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

{
  "id": "11111111-aaaa-bbbb-cccc-222222222223",
  "target_type": "operation",
  "target_name": "example",
  "target_url": "example",
  "titre": "Relancer opérateur",
  "statut": "example",
  "categorie": "example",
  "sort_order": 0
}

{
  "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"
}

{
  "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"
}

Démarrer

Tutoriels

Intégrer

Référence API

Créer une tâche

Authorizations

Headers

Path Parameters

Body

Response