telos customer list
List customers
- --status? — Customer status filter
- --cursor? — Pagination cursor from a previous page
- --limit? — Items per page
Every command is generated from the same action registry that produces the REST routes and MCP tools, and calls REST v1 over HTTPS. The CLI holds no privileged path: the only gate is the capability set on your API key. It ships inside the Telos repository today (pnpm cli), with a packaged standalone binary to follow.
The CLI authenticates with the same bearer key as REST and MCP, read from TELOS_API_KEY. Keys are issued in the app under Settings → API Keys and carry a subset of your own capabilities. TELOS_API_URL overrides the target instance. Responses are the standard REST envelope's data, printed as JSON.
export TELOS_API_KEY=telos_live_…
# optional; defaults to https://www.telos-app.com
export TELOS_API_URL=https://www.telos-app.com
telos customer list --status live
telos customer create --name "Acme Robotics"
telos customer update 8f14e45f-… --status churned --reason "Budget cut"Flags map 1:1 to the action's input fields. For non-string fields (or to script a whole payload), pass --json with a raw body; explicit flags win over the JSON.
telos customer create --name "Acme Robotics" \
--json '{"arr": "120000", "customerSince": "2026-01-05"}'Auto-rendered from the action registry, the same source that renders the REST reference and the MCP catalog. An action that exists on one surface exists on all three.
List customers
Get a customer
Create a customer
Update a customer
Delete a customer
List a customer's contacts
Add a contact to a customer
Update a customer contact
Delete a customer contact
List strategies
Get a strategy
Create a strategy
Update a strategy
Publish a strategy
Archive a strategy
List a strategy's version history
List visions
Get a vision
Create a vision
Update a vision
List a vision's version history
List objectives for a vision
List metrics
Get a metric
Create a metric
Update a metric
Delete a metric
List metric values
Record a metric value
List objectives
Get an objective
Create an objective
Update an objective
Delete an objective
List opportunities for an objective
Set an objective's metric
List opportunities
Get an opportunity
Create an opportunity
Update an opportunity
Delete an opportunity
List tasks attached to an opportunity
Get an opportunity's full context bundle
Get an opportunity's scorecard
Set a scorecard value
Clear a scorecard value
Link an objective to an opportunity
Update an objective link
Unlink an objective from an opportunity
Reject an opportunity and skip remaining workflow steps
Post an opportunity status update
List tasks
Get a task
Create a task
Update a task
Delete a task
Set a task's status
Get a task's full context bundle
Write a subtask handoff note
List recurring tasks
Get a recurring task
Create a recurring task
Update a recurring task
Pause or resume a recurring task
Delete a recurring task
List teams
Get a team
Create a team
Update a team
Delete a team
List team members
Add a team member
Remove a team member
List users
Get a user
Update a user
List tags
Create a tag
Post a comment
List insights
Get an insight
Create an insight
Update an insight
Delete an insight
Attach an insight
List PRD templates
Get a PRD template
Create a PRD template
Update a PRD template
Delete a PRD template
List webhook subscriptions
Create a webhook subscription
Delete a webhook subscription
List workflows
Get a workflow
Create a workflow
Update a workflow
Delete a workflow
Add a workflow step
Update a workflow step
Delete a workflow step
Write a workflow handoff
List workflow categories
Get a workflow category
Create a workflow category
Update a workflow category
Delete a workflow category
List notifications
Get unread notification count
Mark a notification read
Mark all notifications read
Pin a notification
Unpin a notification
Unsubscribe at notification source
List time entries
Log a time entry
Update a time entry
Delete a time entry
Aggregate time by workflow category
List all engineers' time entries with cost
Actual labor cost of an opportunity
Actual labor cost of a task
List your rooms
Get a room
Create a group channel
Update a group channel
Archive a group channel
List a room's messages
List a message's thread replies
Post a message
Edit a message
Delete a message