Aliases

Aliases provide human-readable references to packs you own. They are resolved in the caller's personal or workspace context.

Upsert an alias

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

type is workflow or context. id is the target pack ID. alias may be passed with or without a leading @; the stored value omits @.

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

Resolve or list aliases

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

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

Omit alias to list your aliases. Pass type=workflow or type=context to filter.

Delete an alias

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

Deleting an alias does not delete the pack. Deleting a pack removes aliases you own that point to that pack.