Alias

Los alias proporcionan referencias a paquetes legibles por humanos. Cada alias reside en un espacio de nombres personal (la cuenta de la persona que llama) o un espacio de nombres espacio de trabajo (la cuenta compartida del espacio de trabajo activo). El espacio de trabajo se toma del token de autenticación o del parámetro de consulta workspaceId.

Insertar un alias

PUT /v1/aliases
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "reference": "@existing-pack",
  "alias": "repo-onboarding",
  "namespace": "personal"
}

reference es la referencia del paquete de destino: ID del paquete, alias, URL compartida o URL central. alias se puede pasar con o sin @ inicial; el valor almacenado omite @. namespace es opcional (personal predeterminado o workspace). El type (workflow o context) del registro de alias se deriva del paquete resuelto. Sólo el propietario del paquete puede crear o redireccionarle un alias.

Los nombres de alias tienen de 1 a 255 caracteres después del recorte y la normalización. No pueden incluir / ni caracteres de control.

Resolver o enumerar alias

curl "https://api.epismo.ai/v1/aliases?alias=@repo-onboarding" \
  -H "authorization: Bearer $EPISMO_TOKEN"

# pin resolution to the workspace namespace
curl "https://api.epismo.ai/v1/aliases?alias=@deploy&namespace=workspace" \
  -H "authorization: Bearer $EPISMO_TOKEN"

curl "https://api.epismo.ai/v1/aliases?type=context" \
  -H "authorization: Bearer $EPISMO_TOKEN"

Un @alias simple resuelve primero lo personal y luego el espacio de trabajo activo; pase el parámetro de consulta opcional namespace (personal o workspace) para fijar la resolución a un lado. Omita alias para enumerar sus alias: la lista contiene sus alias personales más, cuando un espacio de trabajo está activo, los alias compartidos del espacio de trabajo. Cada entrada está etiquetada con su namespace y un alias resuelto también devuelve un reference listo para usar. Pase type=workflow o type=context para filtrar.

Eliminar un alias

DELETE /v1/aliases/:alias
Authorization: Bearer <token>

# workspace alias
curl -sX DELETE "https://api.epismo.ai/v1/aliases/%40deploy?namespace=workspace" \
  -H "authorization: Bearer $EPISMO_TOKEN"

namespace es un parámetro de consulta opcional (personal predeterminado o workspace). Solo el propietario del paquete de destino puede eliminar un alias de espacio de trabajo. Eliminar un alias no elimina el paquete. Al eliminar un paquete, se eliminan los alias que posee y que apuntan a ese paquete.