Saltar al contenido principal
GET
Listar ámbitos

Listar Ámbitos

GET /v1/scopes Devuelve todos los ámbitos de permiso disponibles para el inquilino autenticado. Esto incluye los ámbitos incorporados definidos por la plataforma y cualquier ámbito personalizado creado por el inquilino. Los ámbitos siguen el formato resource:action definido por el protocolo MAIP.

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

Devuelve una matriz de objetos de definición de ámbito.
string
UUID de la definición de ámbito.
string
UUID del inquilino propietario de este ámbito. null para los integrados a nivel de plataforma ámbitos.
string
La cadena de alcance completa en formato resource:action (por ejemplo, "data:read", "model:train").
string
El componente de recurso del alcance (por ejemplo, "data", "model", "tool").
string
El componente de acción del alcance (por ejemplo, "read", "write", "*").
string
Nombre legible por humanos para el alcance.
string
Descripción detallada de a qué otorga acceso el ámbito.
string
Categoría de alcance para fines organizativos.
boolean
true para ámbitos definidos por la plataforma, false para ámbitos personalizados creados por el inquilino.
string
Marca de tiempo de creación ISO 8601.

Ejemplo


Categorías de ámbito incorporadas

La plataforma ofrece más de 25 alcances incorporados en 6 categorías:

Referencia de formato de alcance

Autorizaciones

X-API-Key
string
header
requerido

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

Parámetros de consulta

category
enum<string>

Filtrar ámbitos por categoría

Opciones disponibles:
data,
model,
tool,
agent,
admin,
receipt,
custom

Respuesta

Ámbitos disponibles

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