Lire la chronologie narrative d'une opération

Agrège notamment les notes de suivi. Pour une note importée, metadata expose note_date, note_text et note_category.

Scope requis : operations:read. Scopes et délégation.

Lire la chronologie narrative d'une opération

cURL

curl --request GET \
  --url https://partner-api.marko.fr/v1/operations/{operation_id}/chronicle/narrative \
  --header 'Authorization: Bearer <token>'

200

{
  "operation_id": "44444444-4444-4444-4444-444444444444",
  "entries": [
    {
      "id": "cm_aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
      "timestamp": "2026-07-15T09:30:00Z",
      "category": "comment",
      "title": "Note d'appel ajoutée via l'API externe",
      "description": "Pièces complémentaires attendues.",
      "severity": "info",
      "metadata": {
        "note_date": "2026-07-15T09:30:00Z",
        "note_text": "Pièces complémentaires attendues.",
        "note_category": "call"
      }
    }
  ],
  "total": 1,
  "page": 1,
  "pages": 1,
  "limit": 50,
  "sources_queried": [
    "comments"
  ]
}

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

operation_id · string<uuid> · required

UUID MARKO de l'opération.

Query Parameters

category · enum<string> | null

Catégorie de la note; les règles exactes dépendent de la route. Pour l'import externe: chaîne de 1 à 80 caractères, libre par défaut. Category of an operation chronicle narrative entry.

Available options: comment, alert, document, status, reporting

page · integer · default: 1

Numéro de page; consultez la valeur minimale et la valeur par défaut de cette route.

Required range: x >= 1

limit · integer · default: 50

Nombre maximal de résultats sur cette page; bornes et valeur par défaut ci-dessous.

Required range: 1 <= x <= 200

date_from · string<date-time> | null

Paramètre date_from de cette route; contraintes ci-dessous.

date_to · string<date-time> | null

Paramètre date_to de cette route; contraintes ci-dessous.

Response

200

application/json

Successful response

Complete narrative chronicle for an operation.

Aggregates events from multiple sources into a unified, chronologically-sorted timeline with narrative text.

operation_id · string · required

UUID MARKO de l'opération.

entries · OperationChronicleEntry · object[] · required

Événements de la chronologie de l'opération.

Show child attributes

total · integer · required

Nombre total de résultats correspondant aux filtres.

page · integer · default: 1

Numéro de la page courante, à partir de 1.

pages · integer · default: 0

Total pages

limit · integer · default: 50

Items per page

sources_queried · string[]

Data sources included (comment, alert, document, status, reporting)