Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Argus Events API
version: '1'
description: 'Argus API v1: spend, balances and rate-limit headroom across the APIs you pay for.
Authenticate reads with an `api` key as `Authorization: Bearer `. Every key sees one project.
Operations marked `x-access: session` are for the signed-in web app; API keys get `session_required`.
Operations marked `x-web: true` also accept the web app''s session, which API clients never use.
Operations with `x-mcp-key-types` are also MCP tools of the same name at `POST https://mcp.argus.town`, for keys of those types.
Send events with a source secret (`Authorization: Bearer argus_src_...` plus `Argus-Source`) or HMAC headers. A source credential can write events and read nothing; an API key cannot write events.
Responses are bare resources with an `object` tag; lists are `{object: "list", data, has_more, next_cursor}`.
Errors are `{error: {type, code, message, param, doc_url, next_step, request_id}}` with real HTTP statuses.
Unknown query parameters are rejected. Ids are prefixed (`conn_...`); bare ids are accepted on input.
Within v1 changes are additive: ignore fields you do not recognise.'
servers:
- url: https://api.argus.town
tags:
# --- truncated at 32 KB (41 KB total) ---
# Full source: https://artifacts.apis.io/argus-town/openapi/argus-town-events-api-openapi.yml