Progettazione dell'API - restituisce le operazioni che l'utente può eseguire

L'API My Rest restituisce una struttura ad albero come questa:

  [
   {
    "name":"test old",
    "id": 1,
    "type":"a-object",
    "spend":13,
    "status”: “active”,
    "children":[
        {
          "name":"test women old",
          "id": 2,
          "type":"b-object",
          "spend":13,
          "status”: “active”,
          "children":[..]
         }
     ]
   }
  ]

Vorrei dire all'utente per ciascun nodo quali campi potrebbero essere aggiornati ad esempio, per il primo test su un oggetto vecchio può solo impostare lo stato, mentre per l'oggetto b può impostare lo stato, il nome e la spesa.

Qual è il modo dell'API REST per farlo?

Ho provato a cercare un esempio per un'API che fa una cosa del genere e che non ha trovato - ne conosci uno che lo fa?