acomo CLI / API 標準ガイド

前提・実行環境

• acomo CLI が実行できる環境（PATH に

  acomo

  が存在すること）を前提とします。
• エージェントが CLI を実行する場合、リモートサンドボックス等ではローカルの

  ~/.acomo/config.json

  や環境変数が自動継承されないことがあります。CI・エージェント実行時は環境変数（

  ACOMO_ACCESS_TOKEN

  ,

  ACOMO_TENANT_ID

  ,

  ACOMO_BASE_URL

  ）の設定を推奨します。
• 認証未設定時も API コマンドは存在し、実行時に終了コード 2 と stderr の

  AUTH_REQUIRED

  で失敗します。その場合はユーザーに再ログイン（または環境変数設定）を促してください。

認証エラー時の扱い

• acomo login

  の実行、または環境変数

  ACOMO_ACCESS_TOKEN

  ,

  ACOMO_TENANT_ID

  の設定

認証

• ローカル利用:

  acomo login

  で

  ~/.acomo/config.json

  に永続保存。
• CI・エージェント環境: 環境変数での認証を推奨。

# 環境変数で認証（非インタラクティブ向け）
export ACOMO_ACCESS_TOKEN="your-token"
export ACOMO_TENANT_ID="your-tenant-id"

# または login で保存
acomo login --tenant-id <tenantId> --access-token <accessToken>

ACOMO_ACCESS_TOKEN

ACOMO_TENANT_ID

ACOMO_BASE_URL

https://acomo.app

acomo <operationId> --help

呼び出し形式

acomo <operationId> [--option value...] [body-json]

• path/query パラメータ →

  --name value

  形式の named option
• リクエストボディ → 位置引数の JSON 文字列（または stdin）

# path param のみ（GET など）
acomo getWorkflowModel --modelId <ID>

# query params
acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'

# body のみ（POST）
acomo createWorkflowModel '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'

# path param + body（PUT）
acomo saveWorkflowModel --modelId <ID> '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}'

# stdin から body を渡す
echo '{"name":"経費申請","definition":{},"dataSchema":{},"policy":{}}' | acomo createWorkflowModel

標準フロー

1. モデル一覧:

   acomo listWorkflowModels

   で対象モデルを特定する。フィルタ例:

   acomo listWorkflowModels --take 10 --filter '{"name":{"contains":"申請"}}'

2. モデル定義:

   acomo getWorkflowModel --modelId <ID>

   で definition / dataSchema / policy の JSON を取得する。
3. プロセス操作: 必要に応じて

   startWorkflowProcess

   /

   saveWorkflowProcess

   /

   submitWorkflowProcess

   /

   submitWorkflowProcessWithNodeId

   /

   approveWorkflowProcess

   /

   rejectWorkflowProcess

   /

   revertWorkflowProcess

   を使う。自分のプロセス一覧は

   listMyProcesses

   や

   listProcessWithNodeActions

   を検討する。

主要コマンド早見

listWorkflowModels

getWorkflowModel --modelId <ID>

getWorkflowModelWithLatestModelHistory --modelId <ID>

startWorkflowProcess --modelId <ID>

saveWorkflowProcess --processId <ID> '{"data":{...}}'

submitWorkflowProcess --processId <ID>

approveWorkflowProcess --processId <ID>

rejectWorkflowProcess --processId <ID>

revertWorkflowProcess --processId <ID> --nodeId <nodeId>

listMyProcesses

listProcessWithNodeActions

getMyProcesses

getProcessWithNodeActions

saveWorkflowProcess

data

補足

• データ構造（definition / dataSchema / policy / 条件式）の詳細は reference.md を参照する。
• 全コマンド一覧は

  acomo --help

  で確認する。