Saltar al contenido principal
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

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.

Encabezados

X-On-Behalf-Of
string

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

Parámetros de ruta

response_id
string
requerido

El ID de la respuesta.

Cuerpo

application/json

Otorga un rol sobre el recurso, reemplazando cualquier rol que el principal ya tenga. grantee_type tiene el valor predeterminado user.

grantee_type
any
requerido

Subvenciones a un principal.

user_id
string
requerido

El ID de usuario de un miembro, o el ID del usuario final al que se delega una solicitud con X-On-Behalf-Of. No puede contener / ni espacios en blanco, y no puede ser ., .., * ni team.

Minimum string length: 1
role
enum<string>
requerido

El rol a conceder. writer incluye reader.

Opciones disponibles:
writer,
reader

Respuesta

200 - application/json

Está bien

Un rol asumido en una respuesta por un principal, o por todos los miembros del equipo de la respuesta.

object
any
requerido

El tipo de objeto, que siempre es 'response.permission'.

response_id
string
requerido

El ID de la respuesta.

grantee_type
enum<string>
requerido

A quién se aplica el permiso: un principal (user), o cada miembro del equipo del recurso (team).

Opciones disponibles:
user,
team
user_id
string | null
requerido

El principal al que se aplica el permiso: el ID de usuario de un miembro, o el ID del usuario final al que se delega una solicitud con X-On-Behalf-Of. null cuando el permiso se aplica al equipo de la respuesta.

role
enum<string>
requerido

El rol que se tiene en el recurso. owner es el creador del recurso y no puede concederse; writer incluye reader.

Opciones disponibles:
owner,
writer,
reader