list_managed_companies

Elenca le aziende che l’utente connesso è autorizzato a gestire come emittente. Questo è il punto di ingresso per ogni altro strumento emittente — i valori companyId restituiti sono ciò che shareholder_registry, export_shareholder_registry, list_proposals e sign_proposal si aspettano come input.

Autenticazione

Richiede accesso. Chiama sign_in per primo se la sessione è anonima. L’utente connesso deve avere almeno un’autorizzazione emittente sul backend di Aktionariat.

Input

Nessuno.

Output

Un array di riepilogo. Ogni riga contiene i campi necessari per chiamare gli strumenti emittente a valle:

Campo	Tipo	Descrizione
companyId	integer	Id numerico dell’azienda gestita.
companyName	string	Nome completo dell’azienda.
tokenName	string	Nome della classe di azioni tokenizzate.
registerTicker	string	Ticker della classe di azioni registrate.
tradedTicker	string	Ticker della classe di azioni negoziabili.
chain	string	Blockchain (mainnet, optimism).

L’indirizzo del portafoglio dell’utente e l’id interno da GET /authorizations sono intenzionalmente esclusi dalla risposta — non sono utili all’agente.

Prompt di esempio

• “Quali aziende posso gestire su Aktionariat?”
• “Qual è l’id aziendale della mia azienda gestita?”
• “Mostrami la blockchain e i ticker per le aziende che gestisco.”

Note per gli agenti

• Chiama sempre questo strumento prima di qualsiasi altro strumento emittente. Non indovinare i valori di companyId — shareholder_registry, export_shareholder_registry, list_proposals e sign_proposal rifiuteranno gli id per cui l’utente non è autorizzato.
• Se la risposta è vuota, l’utente connesso non ha accesso emittente — comunicaglielo e non chiamare gli strumenti emittente a valle.