Pular para o conteúdo principal
POST
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.

Corpo

application/json

Concede uma função no recurso, substituindo qualquer função que o principal já possua. grantee_type assume o valor padrão user.

grantee_type
any
obrigatório

Concede a um principal.

user_id
string
obrigatório

O ID de usuário de um membro, ou o ID do usuário final para o qual uma solicitação é delegada com X-On-Behalf-Of. Não pode conter / ou espaços em branco, e não pode ser ., .., * ou team.

Minimum string length: 1
role
enum<string>
obrigatório

O papel a ser concedido. writer inclui reader.

Opções disponíveis:
writer,
reader

Resposta

200 - application/json

OK

Uma função mantida em uma conversa por um principal, ou por todos os membros da equipe da conversa.

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>
obrigatório

A função atribuída ao recurso. owner é o criador do recurso e não pode ser concedido; writer inclui reader.

Opções disponíveis:
owner,
writer,
reader