# COSTRINITY Agent API

**Canonical:** https://apis.io/apis/costrinity-xyz/costrinity-xyz-agent-api/  
**Provider:** COSTRINITY — https://apis.io/providers/costrinity-xyz/  
**Base URL:** https://vitna.costrinity.xyz  
**Documentation:** https://vitna.costrinity.xyz/docs

COSTRINITY Agent API is one of 26 APIs that [COSTRINITY](https://apis.io/providers/costrinity-xyz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Agents. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The agent API from COSTRINITY — 17 operation(s) for agent.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/agents/rotate` | Rotate an agent's API key. |
| POST | `/api/agents` | Create an agent. Its API key is returned once |
| DELETE | `/api/agents` | Delete an agent. Its key stops working and its events are deleted with it |
| PATCH | `/api/agents/config` | Change an agent's heartbeat interval, budget caps, anomaly thresholds and… |
| GET | `/api/events` | Read one agent's events, newest first (the dashboard timeline) |
| DELETE | `/api/events` | Delete every event of one agent |
| GET | `/api/events/system` | Count one agent's system events by type, before deleting them |
| DELETE | `/api/events/system` | Delete one agent's system events (heartbeat_missed, budget_warning… |
| POST | `/api/commands` | Send a command to one of your agents (the dashboard's Wake Up button) |
| GET | `/api/stream` | One agent's live events as Server-Sent Events: connected, event, command… |
| GET | `/api/events/export` | Download one agent's events as CSV or JSON |
| GET | `/api/graph` | One agent's activity graph: actions or events as nodes, causal links as edges |
| GET | `/api/cef` | One agent's events for a SIEM, as CEF, LEEF or JSON |
| GET | `/api/anomaly` | One agent's anomaly score and the anomalies found in a time window |
| GET | `/api/health` | With agent_id, one agent's health summary built from its last 7 days of events… |
| GET | `/api/stats` | One agent's statistics: its events, errors and cost over the last 24 hours, its… |
| GET | `/api/compliance` | One agent's events mapped to SOC 2, PCI DSS, ISO 27001, NIST CSF and GDPR… |
| GET | `/api/search` | Search agent names, events and alert rules |
| POST | `/api/setup` | One-command agent self-provisioning: create/resolve an owner and mint an API… |
| POST | `/api/preflight/action-check` | Safety pre-flight: check a dangerous action (shell / file / DB / network)… |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/costrinity-xyz/openapi/costrinity-xyz-agent-api-openapi.yml
- **Documentation** — https://vitna.costrinity.xyz/docs
- **APIsJSON** — https://artifacts.apis.io/costrinity-xyz/apis.yml

## Other COSTRINITY APIs (12)

- [COSTRINITY Alerts API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-alerts-api/)
- [COSTRINITY Assessment API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-assessment-api/)
- [COSTRINITY Audit API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-audit-api/)
- [COSTRINITY Australia API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-australia-api/)
- [COSTRINITY Auth API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-auth-api/)
- [COSTRINITY Billing API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-billing-api/)
- [COSTRINITY Breach API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-breach-api/)
- [COSTRINITY Canada API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-canada-api/)
- [COSTRINITY China API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-china-api/)
- [COSTRINITY Compliance API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-compliance-api/)
- [COSTRINITY Consent API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-consent-api/)
- [COSTRINITY Cron API](https://apis.io/apis/costrinity-xyz/costrinity-xyz-cron-api/)

## Tags

Agents

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/costrinity-xyz/costrinity-xyz-agent-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/costrinity-xyz/.