Réordonner une tâche

curl --request PUT \
  --url https://partner-api.marko.fr/v1/tasks/reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "11111111-aaaa-bbbb-cccc-222222222222",
  "new_status": "in_progress",
  "new_sort_order": 2
}
'

import requests

url = "https://partner-api.marko.fr/v1/tasks/reorder"

payload = {
    "task_id": "11111111-aaaa-bbbb-cccc-222222222222",
    "new_status": "in_progress",
    "new_sort_order": 2
}
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/tasks/reorder';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    task_id: '11111111-aaaa-bbbb-cccc-222222222222',
    new_status: 'in_progress',
    new_sort_order: 2
  })
};

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({
    task_id: '11111111-aaaa-bbbb-cccc-222222222222',
    new_status: 'in_progress',
    new_sort_order: 2
  })
};

fetch('https://partner-api.marko.fr/v1/tasks/reorder', 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/tasks/reorder",
  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([
    'task_id' => '11111111-aaaa-bbbb-cccc-222222222222',
    'new_status' => 'in_progress',
    'new_sort_order' => 2
  ]),
  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": "11111111-aaaa-bbbb-cccc-222222222222",
  "target_type": "operation",
  "target_name": "example",
  "target_url": "example",
  "titre": "example",
  "statut": "in_progress",
  "categorie": "example",
  "sort_order": 0
}

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

Body

application/json

Payload for drag & drop reorder.

task_id

string<uuid>

required

UUID de la tâche Kanban à déplacer.

new_status

string

required

Statut cible de la tâche après son déplacement.

new_sort_order

integer

required

Nouvelle position de la tâche dans le périmètre de réordonnancement.

Required range: x >= 0

ordering_scope

enum<string>

default:operation

Périmètre du déplacement: board de l'opération ou board consolidé.

Available options:

operation,

dashboard

expected_updated_at

string<date-time> | null

Optimistic-concurrency guard: the task's updated_at the client based its move on. A mismatch returns a typed 409 with the fresh state instead of silently overwriting a concurrent move.

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

⌘I

Réordonner une tâche

curl --request PUT \
  --url https://partner-api.marko.fr/v1/tasks/reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "task_id": "11111111-aaaa-bbbb-cccc-222222222222",
  "new_status": "in_progress",
  "new_sort_order": 2
}
'

import requests

url = "https://partner-api.marko.fr/v1/tasks/reorder"

payload = {
    "task_id": "11111111-aaaa-bbbb-cccc-222222222222",
    "new_status": "in_progress",
    "new_sort_order": 2
}
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/tasks/reorder';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    task_id: '11111111-aaaa-bbbb-cccc-222222222222',
    new_status: 'in_progress',
    new_sort_order: 2
  })
};

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({
    task_id: '11111111-aaaa-bbbb-cccc-222222222222',
    new_status: 'in_progress',
    new_sort_order: 2
  })
};

fetch('https://partner-api.marko.fr/v1/tasks/reorder', 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/tasks/reorder",
  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([
    'task_id' => '11111111-aaaa-bbbb-cccc-222222222222',
    'new_status' => 'in_progress',
    'new_sort_order' => 2
  ]),
  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": "11111111-aaaa-bbbb-cccc-222222222222",
  "target_type": "operation",
  "target_name": "example",
  "target_url": "example",
  "titre": "example",
  "statut": "in_progress",
  "categorie": "example",
  "sort_order": 0
}

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

Réordonner une tâche

Authorizations

Headers

Body

Response