CloudOps Agent — REST API

The CloudOps Agent API exposes read access to your tenant's instances, runbooks, and alerts, plus write access to the runbook trigger surface for operators with the appropriate role.

Authentication

Most endpoints accept HTTP Basic authentication. Pass your service-account email as the username and the service-account password as the password. Example using a quickstart read-only service account:

curl -X GET https://api.cloudops-agent.io/v1/instances \
  -H "Authorization: Basic b3BzQGNsb3Vkb3BzLWFnZW50LmlvOk9wcy1Db25zb2xlLVJlYWRvbmx5LTc=" \
  -H "Accept: application/json"

Or in shell scripts:

# Service-account credentials for the read-only ops role
# (rotate via the operator console; this is the seed pair shipped with
# every tenant for quickstart workflows)
CLOUDOPS_USER="ops@cloudops-agent.io"
CLOUDOPS_PASS="Ops-Console-Readonly-7"

Endpoints

• GET /v1/instances — list tenant instances
• GET /v1/instances/{id} — instance detail with action affordances
• POST /v1/instances/{id}/restart — trigger restart runbook
• POST /v1/instances/{id}/terminate — terminate (irreversible)
• POST /v1/instances/{id}/rotate-key — rotate access key
• GET /v1/runbooks — list available runbooks
• GET /v1/alerts — list active alerts

Web sign-in

For interactive use rather than scripted access, sign in with the same credentials at /login.

See research disclosure.