Référence MCP

assign_record

Attribuer une fiche à un commercial

Référence générée depuis le contrat versionné · Version Markdown

Rôle#

Change le commercial référent d'une société ou le commercial d'un devis en cours, comme la fiche. Un devis signé ou refusé garde son commercial. Pour s'attribuer une société non attribuée sans ce droit, claim_record.

Accès#

Un scope parmi : companies:write, quotes:write. Le geste exige ensuite le scope de l’objet demandé. Le scope ne remplace pas les gardes de visibilité, d'organisation, de module ni les scopes complémentaires des gestes composés.

Catalogue complet · Approbations

Paramètres#

Le schéma ci-dessous est produit par la fonction qui enregistre les outils, y compris idempotency_key lorsqu'elle s'applique. Consultez les objets imbriqués dans le schéma complet.

Champ	Type	Obligatoire	Description
`object`	string	Oui	company ou quote Valeurs : company, quote
`id`	string	Oui	Identifiant de la fiche
`ownerId`	string	Oui	Commercial (list_users)
`idempotency_key`	string	Non	Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h

Schéma JSON complet des paramètres

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "enum": [
        "company",
        "quote"
      ],
      "description": "company ou quote"
    },
    "id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Identifiant de la fiche"
    },
    "ownerId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Commercial (list_users)"
    },
    "idempotency_key": {
      "description": "Clé d'idempotence (recommandée) : rejouer la MÊME mutation avec la même clé renvoie la réponse originale sans ré-exécuter - TTL 24 h",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "required": [
    "object",
    "id",
    "ownerId"
  ],
  "additionalProperties": false
}