エイリアス

エイリアスはパックへの人が読みやすい参照です。各エイリアスは 個人用 名前空間(呼び出し元のアカウント)または ワークスペース 名前空間(アクティブなワークスペースの共有アカウント)に属します。ワークスペースは認証トークンまたは workspaceId クエリパラメータから決まります。

エイリアスの作成・更新

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

id は対象パック ID です。alias は先頭 @ あり/なしのどちらでも渡せます。保存値は @ を含みません。namespace は任意です(デフォルト personal、または workspace)。alias レコードの type(workflow または context)はパック ID から導出されます。エイリアスを作成・付け替えできるのは対象パックの所有者だけです。

エイリアス名は、前後の空白除去と正規化の後で1〜255文字です。/ や制御文字は使えません。

エイリアスの解決・一覧

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

# 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"

素の @alias はまず個人用、次にアクティブなワークスペースで解決されます。任意の namespace クエリパラメータ(personal または workspace)を渡すと、解決を片方の名前空間に固定できます。alias を省略すると自分のエイリアスを一覧します。一覧には自分の個人用エイリアスに加えて、ワークスペースがアクティブな場合はそのワークスペースの共有エイリアスも含まれ、各エントリには namespace が付与されます。解決されたエイリアスにはすぐ使える reference も返されます。type=workflow または type=context で絞り込みできます。

エイリアスの削除

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 は任意のクエリパラメータです(デフォルト personal、または workspace)。ワークスペースエイリアスを削除できるのは対象パックの所有者だけです。エイリアスを削除してもパックは削除されません。パックを削除すると、そのパックを指す自分のエイリアスは削除されます。