Saltar al contenido principal
POST
Crear alcance

Crear Ámbito

POST /v1/scopes Crea un ámbito de permiso personalizado para el inquilino autenticado. Los ámbitos personalizados extienden el registro de ámbitos incorporado con permisos específicos del inquilino. La cadena de ámbito se compone automáticamente a partir de los campos resource y action en formato resource:action. Los alcances personalizados se validan según las reglas de formato de alcance MAIP: solo caracteres alfanuméricos, puntos, guiones bajos, guiones y asteriscos.
Los ámbitos personalizados están aislados por inquilino. No aparecen en los ámbitos de otros inquilinos. registros. Los ámbitos de plataforma incorporados no se pueden anular ni duplicar.

Autenticación

Requiere el encabezado X-API-Key o el token Bearer JWT. El espacio de trabajo se deriva de la credencial autenticada; no envíe X-Tenant-ID.

Respuesta

string
UUID de la definición de ámbito recién creada.
string
UUID del inquilino propietario.
string
La cadena de alcance compuesta en formato resource:action.
string
El componente de recurso.
string
El componente de acción.
string
Nombre del ámbito legible por humanos.
string
Descripción del alcance.
string
Categoría de alcance.
boolean
Siempre false para ámbitos creados por el inquilino.
string
Marca de tiempo de creación ISO 8601.

Ejemplo


Asignación de ámbitos personalizados a agentes

Después de crear un alcance personalizado, asígnelo a los agentes durante el registro o mediante delegación:

Autorizaciones

X-API-Key
string
header
requerido

Clave API para autenticación máquina a máquina

Cuerpo

application/json
action
string
requerido

Componente de acción del alcance (por ejemplo, "leer", "aprobar", "*")

resource
string
requerido

Componente de recurso del alcance (por ejemplo, "crm", "payment")

category
string

Categoría organizacional (por defecto "custom")

description
string

Descripción detallada de lo que otorga el ámbito

display_name
string

Nombre legible por humanos para el alcance

Respuesta

Alcance creado

id
string<uuid>
tenant_id
string<uuid>
scope
string
resource
string
action
string
display_name
string
description
string
category
string
is_builtin
boolean
created_at
string<date-time>