API による組織 Skill の作成

指定した組織配下に組織レベルの Skill を作成できます。本インターフェースを使用して、指定した組織配下に組織レベルの Skill を作成できます。

受け付けるのは .skill、.zip のみで、アーカイブの最大サイズは 20 MiB です。
パッケージのルートディレクトリ、または唯一のトップレベルディレクトリの直下に SKILL.md を含める必要があり、その frontmatter には name を含める必要があります。
作成に成功したら、POST /v1/org/skill/update を使用し、Form Data に skill_id を渡して当該 Skill を更新します。

リクエストメソッド

POST

リクエストURL

https://api.${endpoint}/v1/org/skill/create

リクエスト認証

アカウントレベルの DevKey / DevSecret による Basic 認証を使用します。呼び出しアカウントに組織 Skill の作成権限が必要です。

リクエスト

リクエスト例

curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \ -H 'Authorization: Basic ${BASIC_TOKEN}' \ -F 'org_id=org-xxxx' \ -F 'file=@/path/to/refund-policy.skill'

                      
                      curl -X POST 'https://api.${endpoint}/v1/org/skill/create' \
  -H 'Authorization: Basic ${BASIC_TOKEN}' \
  -F 'org_id=org-xxxx' \
  -F 'file=@/path/to/refund-policy.skill'

このコードブロックをポップアップで表示

リクエストヘッダー

フィールド	タイプ	説明
Authorization	Basic ${BASIC_TOKEN}	`DevKey:DevSecret` を Base64 エンコードした Basic Token を使用します。
Content-Type	application/json	リクエストボディの形式。

リクエストパラメータ（Body Parameters）

パラメータ	タイプ	必須	説明
`org_id`	String	はい	共有 Skill を作成する対象の組織 ID。
`file`	File	はい	`.skill` または `.zip` の Skill パッケージ。

レスポンス

レスポンス例

{ "code": 0, "message": "OK", "data": { "skill_id": "skill-xxxx", "name": "refund_policy", "owner_type": "ORGANIZATION" } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "skill_id": "skill-xxxx",
    "name": "refund_policy",
    "owner_type": "ORGANIZATION"
  }
}

このコードブロックをポップアップで表示

成功時のレスポンス

フィールド	タイプ	説明
skill_id	String	新規作成した Skill ID。
name	String	Skill 名称。
owner_type	String	Skill の所属タイプ。

エラー時のレスポンス

フィールド	タイプ	説明
code	Integer	エラーコード。
message	String	エラー詳細。

ステータスコード

ステータスコード	説明
200	成功
400	パラメータエラー
401	未認証
403	権限不足
429	リクエストが頻繁すぎます
500	サーバーエラー