Resource Commands

The CLI exposes every method of @revos/api-client as a topic-prefixed command. Each topic mirrors a resource and supports standard CRUD verbs (list, get, create, update, delete) plus resource-specific extras.

List Flags

All list commands accept pagination, ordering, filtering, and column-projection flags:

revos tables list --page-size 50 --order-by 'createdAt desc'
revos scores list --filter 'scoringModelId == "abc-123"'
revos connections list --columns id,name,status

Flag	Description
--page-size	Maximum number of items to return
--page-token	Token for the next page (from previous response)
--order-by	Field to order results by (e.g. createdAt desc)
--filter	Filter expression in CEL
--fields	Comma-separated list of fields to include
--columns	Override the curated default columns shown in table output

Each list command ships a curated default column set. Use --columns a,b,c to override; pass --json for the full SDK payload.

Filtering with --filter

--filter takes a Common Expression Language expression, not key=value. String values must be quoted — the two mistakes below are rejected by the API, not silently ignored:

# ✅ correct
revos action-runs list --filter 'status == "FAILED"'
revos action-runs list --filter 'objectId == "122398583013"'
revos action-runs list --filter 'status == "FAILED" && createdAt > "2026-01-01"'

# ❌ rejected — not CEL
revos action-runs list --filter 'status=FAILED'
# ❌ rejected — unquoted string value
revos action-runs list --filter 'objectId == 122398583013'

Supported operators: ==, !=, >, >=, <, <=, &&, ||, and parentheses for grouping.

A malformed expression, or a field the resource cannot filter on, returns an error and a non-zero exit code — it never comes back as an empty result set. If a list command prints no rows, it prints (no results), and that genuinely means nothing matched.

Request Bodies (--body)

create and update commands take a --body flag. Three input forms are supported:

# Inline JSON literal
revos tables create --body '{"name":"customers","sql_table":"customers"}'

# Read from file
revos tables create --body @./table.json

# Read from stdin
cat table.json | revos tables create --body -

Invalid JSON is rejected before any HTTP call is made.