Docs
⌘K

CLI: Logs, vectors and AI tools

Read API and audit logs, work with vector embeddings and semantic search, and run the MCP server for AI assistants with sov.

Updated Oct 16, 2026

sov logs

API and audit logs

sov logs api

Show recent API audit events (console Logs → API page).

sov logs api [OPTIONS]

Arguments and options

--limitint rangeoptionaldefault 50
--offsetint rangeoptionaldefault 0
--methodtextoptional
Filter HTTP method (GET, POST, …)
--pathtextoptional
Filter resource/path substring
--actor-idtextoptional
--follow / -fflagoptional
Stream new API log events
--intervalfloat rangeoptionaldefault 2.0
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov logs requests

The project's recent API requests (what the console's Observability › Request logs shows).

sov logs requests [OPTIONS]

Follow mode asks only for requests newer than the last one shown, so it stays cheap.

Arguments and options

--statustextoptional
errors, 5xx, 4xx or 2xx
--servicetextoptional
e.g. atlas-rel, axis, vault, forge, pulse
--search / -stextoptional
Text in the path or method
--sourcetextoptionaldefault app
app (API keys, app users), console or all
--limitint rangeoptionaldefault 50
--follow / -fflagoptional
Keep printing new requests
--intervalfloat rangeoptionaldefault 3.0
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov vector

Vector embeddings and semantic search

sov vector embed

Generate embeddings for text inputs.

sov vector embed [OPTIONS] TEXT

Arguments and options

TEXTtextrequired
One or more texts to embed
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov vector upsert

Embed and upsert documents into a vector collection.

sov vector upsert [OPTIONS] COLLECTION

Arguments and options

COLLECTIONtextrequired
Collection name
--docstextrequired
JSON array: [{"text":"...", "id":"..."}]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov vector collections

List vector collections in the current project scope.

sov vector collections [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov vector records

List records in a vector collection.

sov vector records [OPTIONS] COLLECTION

Arguments and options

COLLECTIONtextrequired
Collection name
--limitintegeroptional
--offsetintegeroptional
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov vector delete-record

Delete one record from a vector collection.

sov vector delete-record [OPTIONS] COLLECTION RECORD_ID

Arguments and options

COLLECTIONtextrequired
Collection name
RECORD_IDtextrequired
Record ID
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov vector delete-collection

Delete an entire vector collection.

sov vector delete-collection [OPTIONS] COLLECTION

Arguments and options

COLLECTIONtextrequired
Collection name
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov mcp

MCP server for AI assistants (Claude, Cursor)

sov mcp serve

Run the MCP server over stdio using your current login and scope.

sov mcp serve [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov mcp config

Print an MCP client config entry that launches sov mcp serve.

sov mcp config

Related

CLI referenceConnect your app
Something unclear or missing on this page?Tell us