Pular para o conteúdo principal
GET
Python (SDK)

Autorizações

Authorization
string
header
obrigatório

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Cabeçalhos

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parâmetros de caminho

conversation_id
string
obrigatório

O ID da conversa.

user_id
string
obrigatório

O principal: o ID de usuário de um membro, o ID do usuário final para o qual uma solicitação é delegada com X-On-Behalf-Of, ou "team" para a permissão que se aplica a todos os membros da equipe da conversa.

Minimum string length: 1

Resposta

200 - application/json

OK

A permissão efetiva de um principal em uma conversa, junto com sua origem.

object
any
obrigatório

O tipo de objeto, que é sempre 'conversation.permission'.

conversation_id
string
obrigatório

O ID da conversa.

grantee_type
enum<string>
obrigatório

A quem a permissão se aplica: um principal (user) ou todos os membros da equipe do recurso (team).

Opções disponíveis:
user,
team
user_id
string | null
obrigatório

O principal ao qual a permissão se aplica: o ID de usuário de um membro, ou o ID do usuário final ao qual uma solicitação é delegada com X-On-Behalf-Of. null quando a permissão se aplica à equipe da conversa.

role
enum<string> | null
obrigatório

O papel mais alto que o principal possui na conversa, ou nulo quando não possui nenhum.

Opções disponíveis:
owner,
writer,
reader
source
enum<string>
obrigatório

De onde a função vem: do proprietário do recurso, de uma permissão detida por este principal, da permissão team do recurso, ou de nada — o principal alcança o recurso apenas como um administrador da organização da sua equipe, se é que o alcança.

Opções disponíveis:
owner,
grant,
team,
none