Getting started
personas
This page is the command reference for @orchestor-inc/cli.
Commands
orc personas list— List personasorc personas create— Create a personaorc personas get— Get a personaorc personas update— Update a personaorc personas delete— Soft-delete a persona
orc personas list
List personas
Usage
orc personas list [flags]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--limit | number | No | Maximum number of items to return |
--cursor | string | No | Opaque cursor for the next page |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc persona list
Help
orc personas list --helporc personas create
Create a persona
Usage
orc personas create [flags]Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--idempotency-key | string | No | 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. |
--name | string | No | (required) Body field: name |
--description | string | No | Body field: description; (use "null" or "reset" to clear) |
--persona | string | No | 3-axis structure: behavior + demographics + employment. All fields nullable to minimize initial input friction. Field names use camelCase.; (JSON object, e.g. '{"custom_id":"x"}') |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc persona create
Help
orc personas create --helporc personas get
Get a persona
Usage
orc personas get <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Path parameter: id |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc persona get
Help
orc personas get --helporc personas update
Update a persona
Usage
orc personas update <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Path parameter: id |
Flags
| Flag | Type | Required | Description |
|---|---|---|---|
--name | string | No | Body field: name |
--description | string | No | Body field: description; (use "null" or "reset" to clear) |
--persona | string | No | 3-axis structure: behavior + demographics + employment. All fields nullable to minimize initial input friction. Field names use camelCase.; (JSON object, e.g. '{"custom_id":"x"}') |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc persona update
Help
orc personas update --helporc personas delete
Soft-delete a persona
Usage
orc personas delete <id> [flags]Arguments
| Argument | Required | Description |
|---|---|---|
id | Yes | Path parameter: id |
See global flags for output and request options. Use --help to check the flags supported by this command.
Compatibility aliases
orc persona delete
Help
orc personas delete --help