Skip to content

Developers · terminal

Use Spiron from your terminal.

A dedicated Spiron command-line tool is not publicly available yet. Until it is, any terminal with curl can reach the full API at https://api.spiron.ai.

API
https://api.spiron.ai
Tools
curl, plus jq for JSON
Authentication
Bearer token
On this page4 sections
  1. 01From a terminal today
  2. 02Examples
  3. 03In scripts
  4. 04Read next

From a terminal today

Set your token once.

Keep the token in an environment variable so it stays out of your shell history and scripts.

setup
export SPIRON_TOKEN="…"  # your Spiron access token

Examples

Common tasks.

Pipe the output through jq to pick out the fields you need.

list agents
curl -s https://api.spiron.ai/api/talents \
  -H "Authorization: Bearer $SPIRON_TOKEN" | jq
recent conversations
curl -s https://api.spiron.ai/api/sessions \
  -H "Authorization: Bearer $SPIRON_TOKEN" | jq

In scripts

Automate the routine.

Because it is plain HTTP, the same calls work in cron jobs, CI pipelines, and internal tools.

Keep tokens out of logs

Store the token in your CI or server's secret store, and do not echo it in build output.