プラットフォーム API 参照

このページに

• ベースURL
• [認証]
• [健康診断]
• [アクションレイヤ]
• [データセット (6) ]
• [訓練 (6) ]
• モデル (4)
• [艦隊 (6) ]
• [注釈 (4) ]
• [組織 (3) ]
• 州 (2)
• [エラーコード] T92
• [スケープ参照]

---

アゲント&デブ アクセス

• [エージェントアクセス概要]
• [プラットフォーム API参照]
• [CLIガイド]
• [MCP統合]

---

参照

• [←すべてのウィキ記事]
• [SDK クイックスタート]
• プラットフォーム →

API参照 REST + JSON

CenterOS の REST API 参照を完了します. 9 つのカテゴリーで 39 つのアクションが,すべて単一のエンドポイントで検出できます.

2026年4月更新 39のアクション JWT + PAT auth

ベース URL

すべてのAPIエンドポイントは,生産バックエンドに相対する.

https://fearless-backend-533466225971.us-central1.run.app

ローカル開発では,Vite dev サーバが自動で T0 から T1 にプロキシをします.また,CLI および MCP サーバのベース URL をオーバーライドするために,環境変数 T2 を使用できます.

認証

API は 2 つの認証方法をサポートします.すべての認証エンドポイントには, T3 ヘッダーで T4 トークンが必要です.

JWT (セッショントークン)

ユーザー名とパスワードでログインすることで取得します 短期間でインタラクティブなセッションに適しています

シェル コピー

ログインしてJWTを入手 $ curl -X POST T106 \ -H "コンテンツタイプ:アプリケーション/json" \ -d '{"ユーザー名": "jerry", "パスワード": "***"}"

応答には: {"アクセス_トークン": "eyJ...", "ユーザー": {...}}

PAT (個人アクセストークン)

CI/CDパイプライン,スクリプト,エージェントワークフローのための長寿トークン.PATトークンはT5前記から始まります.CLIまたはプラットフォームダッシュボードを通じて作成します.

シェル コピー

# CLI を介して PAT を作成する セントロスのパット作成 - 名前 "私の代理人" - スコープ "*" 作成されたPAT:frl_abc123...

\ # API コールでPATを使用する $ カール T107 \ -H "許可: 持ち主 FRL_abc123"...

** 対象トークン:** PATは特定の許可まで対象にできます (例えば T6). 完全アクセスのために T7 を使用します. API は,トークンの範囲に基づいて見えるアクションをフィルタします.

健康診断

シェル コピー

T108

状況: "OK", "バージョン": "...",データベース: "OK"}

認証は必要ありません. バックエンドが健全であるときに T8 を返します.

アクションレイヤ

アクションレイヤーは,プラットフォーム UI,CLI,MCPサーバー,AIエージェントが共有する統一 API 表面である.すべての39つのアクションは,2つのエンドポイントで発見できます.

Method	Endpoint	Description
GET	/api/actions	List all available actions with input schemas. Optionally filter by ?category=datasets.
POST	/api/actions/{name}	Execute an action by name. Body: {"params": {...}}. Requires Bearer token.

行動を発見する

シェル コピー

# すべてのアクションをリストする (公開 発見に必要なAuthは不要) T109

カテゴリー別フィルター T110

実行する

シェル コピー

$ カール -X POST T111 \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d "{"params": {"limit": 10}}"

本当だ データは

データのセット

ロボットデータセット管理 リスト,詳細を取得,アップロード,削除.範囲:データセット:読みデータセット:書き込み

Action	Description	Required Params	Scope
list_datasets	List datasets with optional search, file type, and pagination filters.	None	datasets:read
get_dataset	Get detailed information about a single dataset.	dataset_id	datasets:read
delete_dataset	Delete a dataset and its associated file from storage.	dataset_id	datasets:write
upload_dataset	Create a dataset record (metadata). For file upload, use get_upload_signed_url.	name	datasets:write
get_upload_signed_url	Generate a GCS signed URL for direct-to-cloud dataset upload.	filename, file_size	datasets:write
confirm_upload	Confirm that a signed-URL upload completed. Marks the dataset as ready.	dataset_id	datasets:write

シェル コピー

\ # 検索フィルターでデータセットをリストする $ curl -X POST .../api/actions/list_datasets \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"params": {"search": "grasp", "file_type": "hdf5", "limit": 20}}"

# アップলোডフロー:署名 URL,ファイルアップロード,確認 $ curl -X POST .../api/actions/get_upload_signed_url
-H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"パラメータ": {"ファイル名": "episode_001.hdf5", "ファイル_size": 52428800}}"

訓練

訓練・調整・訓練の仕事を作成・管理する 対象:訓練:読み訓練:書き込み

Action	Description	Required Params	Scope
list_training_jobs	List training jobs with optional status and model type filters.	None	training:read
create_training_job	Create a new training or fine-tuning job from one or more datasets.	dataset_ids	training:write
get_training_status	Get the current status and details of a training job.	job_id	training:read
launch_training	Launch a pending training job (transition to running).	job_id	training:write
get_finetune_catalog	List all supported fine-tuning base model providers and models.	None	training:read
estimate_cost	Estimate the cost of a training run based on datasets and infra.	None	training:read

シェル コピー

訓練の仕事を作ろう 訓練・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用・雇用 -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"params": {"name": "dp-v1", "model_type": "diffusion_policy", "dataset_ids": [1, 2], "mode": "finetune"}}"

待機中の仕事を開始する 訓練・訓練・訓練・訓練・訓練 -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d "{"params": {"job_id": "abc123def456"}}"

モデル

ライフサイクル管理のモデルレジストリ 対象:モデル:読み込みモデル:書き込み

Action	Description	Required Params	Scope
list_models	List model versions with optional status and name filters.	None	models:read
register_model	Register a new model version in the model registry.	name	models:write
promote_model	Promote a model through lifecycle stages: draft → validated → deployed → retired.	model_id, target_status	models:write
get_model_lineage	Get full lineage: training job, datasets, deployments, evaluations.	model_id	models:read

シェル コピー

訓練のモデルを登録する $curl -X POST .../api/actions/register_model \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"パラム": {"名称": "dp-v1", "芸術品_uri": "gs://bucket/model.pt", "訓練_job_id": "abc123"}}"

認証に推進する $curl -X POST .../api/actions/promote_model \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"パラメータ": {"モデル_id": 5, "ターゲット_状態": "有効化"}}"

艦隊

ロボット艦隊管理,部署,安全コマンド 対象:艦隊:読み艦隊:書き込み

Action	Description	Required Params	Scope
get_fleet_summary	High-level fleet summary: counts by status, alerts, tickets.	None	fleet:read
list_robots	List robots with optional status, site, and search filters.	None	fleet:read
get_robot_state	Detailed state of a single robot: heartbeat, commands, alerts.	robot_id	fleet:read
register_robot	Register a new robot in the fleet.	robot_id	fleet:write
deploy_model	Deploy a validated model version to a specific robot.	robot_id, model_version_id	fleet:write models:read
emergency_stop	Send an emergency stop (e-stop) command to a robot. Highest priority.	robot_id	fleet:write

シェル コピー

ロボットを登録する $curl -X POST .../api/actions/register_robot \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"params": {"ロボット_id": "arm-01", "name": "Lab Arm 1", "robot_type": "arm"}}"

モデルをロボットに配備する $curl -X POST .../api/actions/deploy_model \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"パラメータ": {"ロボット_id": "arm-01", "モデル_バージョン_id": 5, "戦略": "即時"}}"

緊急停止 $curl -X POST .../api/アクション/緊急_stop \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"パラメータ": {"ロボット_id": "arm-01", "理由": "安全_チェック"}}"

記号

データ注釈タスク管理と品質指標 対象:注釈:読み解く注釈:書き込み

Action	Description	Required Params	Scope
list_annotation_tasks	List annotation tasks with optional status, assignee, and search filters.	None	annotations:read
create_annotation_task	Create a new annotation task, optionally linked to a dataset.	None (title recommended)	annotations:write
get_annotation_metrics	Aggregated quality metrics: pass rate, review counts, status distribution.	None	annotations:read
submit_task	Submit an annotation task for review (transition to in_review).	task_id	annotations:write

シェル コピー

# 注記作業を作成する $ curl -X POST .../api/actions/create_annotation_task \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d '{"params": {"title": "ラベルキャププテルのエピソード", "データセット_id": 42, "データ_type": "ビデオ", "優先度": "高い"}}"

組織

組織とチームメンバー管理 対象:orgs:read orgs:write

Action	Description	Required Params	Scope
list_orgs	List organizations. Superadmins see all; others see only their org.	None	orgs:read
list_org_members	List members of an organization with their roles.	None (org_id optional)	orgs:read
invite_member	Invite a user to an organization. Creates the user if they do not exist.	org_id, email	orgs:write

統計

プラットフォーム全体統計とシステム健康チェック 範囲:統計:読み

Action	Description	Required Params	Scope
get_platform_stats	Aggregated platform statistics: dataset counts, training jobs, robots, annotations.	None	stats:read
get_system_health	Check the health of backend systems: database, storage, overall status.	None	stats:read

シェル コピー

プラットフォームの統計を入手 $curl -X POST .../api/actions/get_platform_stats \ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d "{"パラム": {}}"

システム健康をチェック 医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・医療・ -H "許可: 持ち主から... " -H "コンテンツタイプ:アプリケーション/json" \ -d "{"パラム": {}}"

エラーコード

すべてのアクションエラーは, T66と適切な HTTP ステータスコードを入力した JSON ボディを返します.

Code	Meaning	Common Cause
400	Bad Request	Missing required parameter or invalid value.
401	Unauthorized	Missing or invalid Bearer token.
403	Forbidden	Token scopes do not include the required permission, or org isolation violation.
404	Not Found	Unknown action name, or resource (dataset, model, robot) does not exist.
409	Conflict	Duplicate resource (e.g. robot already registered, user already a member).
413	ペイロード Too Large	File exceeds the maximum upload size.
500	Internal Server Error	Unhandled exception in the action handler.

対象基準

域は,トークンがアクセスできるアクションを制御する.PATは特定の域で作成され,JWTsはユーザーの役割から域を抽出する.

Scope	Actions Granted
datasets:read	list_datasets, get_dataset
datasets:write	delete_dataset, upload_dataset, get_upload_signed_url, confirm_upload
training:read	list_training_jobs, get_training_status, get_finetune_catalog, estimate_cost
training:write	create_training_job, launch_training
models:read	list_models, get_model_lineage
models:write	register_model, promote_model
fleet:read	get_fleet_summary, list_robots, get_robot_state
fleet:write	register_robot, deploy_model, emergency_stop
annotations:read	list_annotation_tasks, get_annotation_metrics
annotations:write	create_annotation_task, submit_task
orgs:read	list_orgs, list_org_members
orgs:write	invite_member
stats:read	get_platform_stats, get_system_health
*	All actions (wildcard)

役割による地図作成

Role	Scopes
admin	All scopes
operator	datasets:*, training:*, models:read, fleet:*, annotations:*, stats:read
annotator	datasets:read, annotations:*, stats:read
viewer	All :read scopes

次のステップ

CLIガイド 端末ベースのワークフローのために CenterOS CLI を使用する → MCP 統合 プラットフォームにClaude,Cursor,またはWindsurf を接続する → エージェント アクセス概要 プラットフォームをプログラム的にアクセスする3つの方法 → ブラウザでデータセット,トレーニング,艦隊を管理するプラットフォームを開く →