Saltar al contenido principal
POST
Create asset group

Descripción general

Crea un nuevo grupo de Assets (activos digitales: URL, direcciones, perfiles, apps, etc.) para ordenar los assets de tu organización. Los grupos te ayudan a clasificar los assets por tipo, proyecto, propósito o cualquier otro criterio que tenga sentido para tu caso de uso.

Inicio rápido

Autenticación

Incluye tu clave de API en el encabezado X-API-KEY:

Solicitud de ejemplo

Cuerpo de la solicitud

Respuesta

Respuesta exitosa

Campos de la respuesta

Respuestas de error

400 Bad Request

Se devuelve cuando la solicitud tiene un formato incorrecto o falla la validación:

401 Unauthorized

Se devuelve cuando la clave de API falta, no es válida o no tiene acceso a la organización:

409 Conflict

Se devuelve cuando ya existe un grupo con el mismo nombre:

Buenas prácticas

Convenciones de nombres

Usa nombres claros y descriptivos que reflejen el propósito del grupo:

Verifica si ya existe el grupo

Antes de crear un grupo, verifica si ya existe uno con el mismo nombre:

Creación de grupos por lotes

Crea varios grupos en secuencia:

Casos de uso

Inicializar la estructura de grupos

Configura una estructura de grupos estándar para una organización nueva:

Grupos por proyecto

Crea grupos para distintos proyectos:

Grupos por entorno

Organiza por entorno (producción, staging, desarrollo):

Creación dinámica de grupos

Crea grupos de forma dinámica según el tipo de asset:

Mensajes de error comunes

Notas

  • Los nombres de los grupos deben ser únicos dentro de tu organización
  • Los nombres distinguen entre mayúsculas y minúsculas al verificar que sean únicos
  • Los nombres de los grupos tienen una longitud máxima de 255 caracteres
  • La organización se determina automáticamente a partir de tu clave de API
  • Los grupos recién creados empiezan con cero assets
  • Los grupos se pueden renombrar más adelante con el endpoint de actualización
  • No hay un límite fijo para la cantidad de grupos por organización

Autorizaciones

X-API-KEY
string
header
requerido

Your API key. This is required by most endpoints to access our API programatically. Reach out to us at support@chainpatrol.io to get an API key for your use.

Cuerpo

application/json

Create a new asset group

Creates a new asset group for organizing your organization's assets.

name
string
requerido

Name for the new group

Required string length: 1 - 255

Respuesta

Successful response

Created group

id
number
requerido

Created group ID

name
string
requerido

Group name