CLI を使い始める
files
@orchestor-inc/cli のコマンドリファレンスです。
コマンド一覧
orc files list— List uploaded filesorc files create— Upload a fileorc files get— Retrieve file metadataorc files content get— Download file binary contentorc files content update— Upload file binary content
orc files list
List uploaded files
構文
orc files list [flags]フラグ
| フラグ | 型 | 必須 | 説明 |
|---|---|---|---|
--purpose | string | いいえ | Filter by file purpose. Pass knowledge-base to list the workspace's evidence-corpus / knowledge-base documents.; enum: agent-context|brand-asset|document|screenshot|export|profile-image|docs-asset|domain-favicon|knowledge-base |
--owner-type | string | いいえ | Owner type for an ownership filter. Must be paired with one or more repeated owner_id values. Issue attachments use issue.; enum: issue |
--owner-id | string | いいえ | Owner ID values for an ownership filter. Repeat this parameter to return files owned by any of several issues in one read.; csv |
--order | string | いいえ | Sort order by created_at, then id.; enum: asc|desc |
--limit | number | いいえ | Maximum number of items to return |
--cursor | string | いいえ | Opaque cursor for the next page |
出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。
ヘルプ
orc files list --helporc files create
Upload a file
構文
orc files create [flags]フラグ
| フラグ | 型 | 必須 | 説明 |
|---|---|---|---|
--idempotency-key | string | いいえ | Unique key for idempotent POST requests (24h TTL). If a request with the same key was already processed, the original response is returned without re-executing the operation. Reusing a key with a different request payload returns 409 idempotency_error. Use a UUID v4 or similar unique identifier. |
--purpose | string | いいえ | (required) What the file is used for. Use knowledge-base for evidence-corpus documents that ground brand context and reporting. See the File.purpose enum for the full set of canonical values. |
--filename | string | いいえ | (required) Body field: filename |
--mime-type | string | いいえ | (required) Body field: mime_type |
--byte-size | number | いいえ | (required) Body field: byte_size |
--sha256 | string | いいえ | Body field: sha256 |
--metadata | string | いいえ | Body field: metadata; (JSON object, e.g. '{"custom_id":"x"}') |
--owner-ref | string | いいえ | Structured ownership reference stored in File.owner_refs. For issue attachments the type is issue and the id is the issue ID.; (JSON object, e.g. '{"custom_id":"x"}') |
出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。
ヘルプ
orc files create --helporc files get
Retrieve file metadata
構文
orc files get <file-id> [flags]引数
| 引数 | 必須 | 説明 |
|---|---|---|
file-id | はい | Path parameter: fileId |
出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。
ヘルプ
orc files get --helporc files content get
Download file binary content
構文
orc files content get <file-id> [flags]引数
| 引数 | 必須 | 説明 |
|---|---|---|
file-id | はい | Path parameter: fileId |
出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。
ヘルプ
orc files content get --helporc files content update
Upload file binary content
構文
orc files content update <file-id> [flags]引数
| 引数 | 必須 | 説明 |
|---|---|---|
file-id | はい | Path parameter: fileId |
出力とリクエストの共通オプションはグローバルオプションを参照してください。このコマンドで使えるフラグは --help で確認できます。
ヘルプ
orc files content update --help