Aliases

Aliases provide human-readable references to packs. Each alias lives in a personal namespace (the caller's account) or a workspace namespace (the active workspace's shared account). The workspace is taken from the auth token or the workspaceId query parameter.

Upsert an alias

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

id is the target pack ID. alias may be passed with or without a leading @; the stored value omits @. namespace is optional (personal default, or workspace). The alias record's type (workflow or context) is derived from the pack ID. Only the pack's owner may create or repoint an alias to it.

Alias names are 1 to 255 characters after trimming and normalization. They cannot include / or control characters.

Resolve or list aliases

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"

A bare @alias resolves personal-first, then the active workspace; pass the optional namespace query parameter (personal or workspace) to pin resolution to one side. Omit alias to list your aliases — the list contains your personal aliases plus, when a workspace is active, the workspace's shared aliases. Each entry is tagged with its namespace, and a resolved alias also returns a ready-to-use reference. Pass type=workflow or type=context to filter.

Delete an 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 is an optional query parameter (personal default, or workspace). A workspace alias can be deleted only by the target pack's owner. Deleting an alias does not delete the pack. Deleting a pack removes aliases you own that point to that pack.