Mettre à jour une vue sauvegardée du sujet délégué

curl --request PUT \
  --url https://partner-api.marko.fr/v1/users/me/saved-views/{view_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Pipeline closing v2",
  "is_default": true
}
'

import requests

url = "https://partner-api.marko.fr/v1/users/me/saved-views/{view_id}"

payload = {
    "name": "Pipeline closing v2",
    "is_default": True
}
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/users/me/saved-views/{view_id}';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Pipeline closing v2', is_default: true})
};

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({name: 'Pipeline closing v2', is_default: true})
};

fetch('https://partner-api.marko.fr/v1/users/me/saved-views/{view_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/users/me/saved-views/{view_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([
    'name' => 'Pipeline closing v2',
    'is_default' => true
  ]),
  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-1111-1111-1111-111111111111",
  "user_id": "example",
  "entity_type": "example",
  "name": "Pipeline closing v2",
  "filters": {},
  "columns": [],
  "sort": {},
  "is_default": true,
  "created_at": "2026-10-01T10:00:00Z",
  "updated_at": "2026-10-01T10:00:00Z"
}

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

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

X-Marko-Delegated-User-Id

string

Fournir exactement un des deux headers de délégation (Id ou Email), dans la même entité. Ils sont mutuellement exclusifs. Voir le guide Scopes et délégation.

X-Marko-Delegated-User-Email

string

Fournir exactement un des deux headers de délégation (Id ou Email), dans la même entité. Ils sont mutuellement exclusifs. Voir le guide Scopes et délégation.

Path Parameters

view_id

string<uuid>

required

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

Body

application/json

État de vue limité à 16 384 octets JSON pour filters, columns et sort. Le nom est normalisé et doit rester non vide. Les allowlists operations sont contrôlées selon le type de la vue, y compris lors d'un update.

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

icon

enum<string> | null

Icône d'affichage de la vue sauvegardée; respecter la liste de valeurs autorisées.

Available options:

bookmark,

briefcase,

building,

calendar,

chart,

clock,

filter,

flag,

shield,

star,

table,

target

color

enum<string> | null

Couleur d'affichage; respecter les valeurs ou le format indiqués dans le schéma.

Available options:

amber,

cyan,

emerald,

rose,

slate,

violet

filters

object | null

Filtres enregistrés pour la vue, le dashboard ou le template.

columns

string[] | null

Colonnes à afficher, dans l'ordre transmis.

Maximum array length: 64

Pattern: ^[a-z][a-z0-9_]{0,63}$

sort

object | null

Critères de tri enregistrés pour la vue.

is_default

boolean | null

Indique si cette vue ou ce template est défini par défaut.

Response

Successful response

Response for a single saved view.

string<uuid>

required

Identifiant MARKO de la ressource.

user_id

string

required

Identifiant utilisateur MARKO; il n'est pas nécessairement un UUID.

entity_type

string

required

Type de ressource auquel se rapporte la vue ou le traitement.

name

string

required

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

filters

Filters · object

required

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

columns

string[]

required

Colonnes à afficher, dans l'ordre transmis.

sort

Sort · object

required

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

is_default

boolean

required

Indique si cette vue ou ce template est défini par défaut.

created_at

string<date-time>

required

Date de création au format ISO 8601.

updated_at

string<date-time>

required

Date de dernière modification au format ISO 8601.

icon

string

default:bookmark

Icône d'affichage de la vue sauvegardée; respecter la liste de valeurs autorisées.

color

string

default:slate

Couleur d'affichage; respecter les valeurs ou le format indiqués dans le schéma.

⌘I

Mettre à jour une vue sauvegardée du sujet délégué

curl --request PUT \
  --url https://partner-api.marko.fr/v1/users/me/saved-views/{view_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Pipeline closing v2",
  "is_default": true
}
'

import requests

url = "https://partner-api.marko.fr/v1/users/me/saved-views/{view_id}"

payload = {
    "name": "Pipeline closing v2",
    "is_default": True
}
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/users/me/saved-views/{view_id}';
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({name: 'Pipeline closing v2', is_default: true})
};

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({name: 'Pipeline closing v2', is_default: true})
};

fetch('https://partner-api.marko.fr/v1/users/me/saved-views/{view_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/users/me/saved-views/{view_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([
    'name' => 'Pipeline closing v2',
    'is_default' => true
  ]),
  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-1111-1111-1111-111111111111",
  "user_id": "example",
  "entity_type": "example",
  "name": "Pipeline closing v2",
  "filters": {},
  "columns": [],
  "sort": {},
  "is_default": true,
  "created_at": "2026-10-01T10:00:00Z",
  "updated_at": "2026-10-01T10:00:00Z"
}

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

{
  "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 une vue sauvegardée du sujet délégué

Authorizations

Headers

Path Parameters

Body

Response