Vai alla navigazione

Condividi risorsa del workspace

Assegna un ruolo (uno tra ‘admin’, ‘editor’, ‘commenter’ o ‘viewer’) su una risorsa del workspace a un utente, un gruppo o una chiave API del workspace (account di servizio). Questo sovrascrive qualsiasi ruolo esistente che il destinatario ha sulla risorsa. Per selezionare un utente o un account di servizio, passa solo l’email dell’utente; l’utente deve appartenere al tuo workspace. Per selezionare un gruppo, passa solo l’ID del gruppo. Per selezionare una chiave API del workspace (account di servizio), passa l’ID della chiave API; la risorsa verrà condivisa con l’account di servizio associato a quella chiave. Per condividerla, devi disporre dell’accesso admin alla risorsa.

Parametri di percorso

resource_idstringObbligatorio
L'ID della risorsa di destinazione.

Header

xi-api-keystringOpzionale

Richiesta

This endpoint expects an object.
roleenumObbligatorio

Ruolo da assegnare alla destinazione: uno tra 'admin', 'editor', 'commenter' o 'viewer'.

Valori consentiti:
resource_typeenumObbligatorio
Tipo di risorsa della risorsa di destinazione.
user_emailstring or nullOpzionale
L'email dell'utente o dell'account di servizio.
group_idstring or nullOpzionale

L'ID del gruppo di destinazione. Usa 'default' per impostare il ruolo di base della risorsa: ogni membro del workspace riceve questo ruolo, a meno che non ne possieda uno superiore tramite un'autorizzazione diretta dell'utente, l'appartenenza a un gruppo o una chiave API del workspace (account di servizio).

workspace_api_key_idstring or nullOpzionale

L'ID della chiave API del workspace di destinazione (account di servizio). Non è la stringa della chiave API che passi nell'header per l'autenticazione: è l'ID della chiave, che gli amministratori del workspace possono trovare in Sviluppatori → Account di servizio.

Risposta

Risposta riuscita

Errori

422
Unprocessable Entity Error