Discovery needs no key. Ratings and market analysis are Pro.
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: Agnost AI System API
description: 'Complete REST API for Agnost AI: an analytics and monitoring platform for AI agents.
**Authentication**:
- SDK ingestion endpoints (`/api/v1/*`) use `x-org-id` header (UUID)
- Dashboard endpoints use `Authorization: Bearer ` + `x-org-id` header, or `x-api-key` header
- API key management uses JWT only (no API key auth)'
version: 2.1.2
contact:
name: Agnost AI
url: https://agnost.ai
servers:
- url: https://api.agnost.ai
description: Production
tags:
- name: System
description: Health checks, webhooks, internal endpoints
paths:
/healthz:
get:
tags:
- System
summary: Health check
operationId: healthCheck
security: []
responses:
'200':
description: Service is healthy
content:
text/plain:
schema:
type: string
example: ok
/webhooks/stripe:
post:
tags:
- System
summary: Stripe webhook
operationId: stripeWebhook
security: []
description: Verified via Stripe-Signature header
requestBody:
content:
application/json:
schema:
type: object
responses:
'200':
description: Webhook processed
'400':
description: Invalid signature
components:
securitySchemes:
OrgId:
type: apiKey
in: header
name: x-org-id
description: Organization ID (UUID). Used by SDKs for event ingestion. Header is case-insensitive.
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: JWT token from OAuth login.
ApiKey:
type: apiKey
in: header
name: x-api-key
description: API key (`agnost_<64-hex>`) for programmatic dashboard access. Issued via Settings → API Keys.
OrgScope:
type: apiKey
in: header
name: x-org-id
description: Optional. Selects which organization a JWT- or API-key-authenticated request targets when the credential has access to multiple.