API Overview

The PromptJang API is RESTful, uses JSON for request/response bodies, and requires Bearer token authentication.

Base URL

https://api.promptjang.net

Authentication

All endpoints (except health and Stripe webhooks) require:

Authorization: Bearer pj_live_YOUR_API_KEY

See Authentication for details.

Content Type

All request bodies must be application/json. All responses are application/json.

Common Patterns

IDs

All resource IDs are 32-character hex strings (128-bit crypto-random):

7a337feef0633bcfa20ae1b0ba3e0372

Timestamps

All timestamps are ISO 8601 (RFC 3339):

2026-05-26T12:00:00Z

Pagination

List endpoints support limit and offset query parameters:

GET /api/v1/events?limit=50&offset=100

Default limit: 50. Maximum limit: 100.

Security Headers

All responses include:

Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
X-Content-Type-Options: nosniff
X-Frame-Options: DENY
Cache-Control: no-store

Endpoints Summary

Method	Path	Description
GET	/health	Health check
POST	/e/:endpoint_id	Ingest event
GET	/api/v1/orgs	Get organization
PATCH	/api/v1/orgs	Update organization
GET	/api/v1/endpoints	List endpoints
POST	/api/v1/endpoints	Create endpoint
GET	/api/v1/endpoints/:id	Get endpoint
PATCH	/api/v1/endpoints/:id	Update endpoint
DELETE	/api/v1/endpoints/:id	Delete endpoint
GET	/api/v1/keys	List API keys
POST	/api/v1/keys	Create API key
DELETE	/api/v1/keys/:id	Delete API key
GET	/api/v1/events	List events
GET	/api/v1/events/:id	Get event
POST	/api/v1/events/:id/replay	Replay event
GET	/api/v1/stats	Delivery statistics
POST	/api/v1/billing/checkout	Stripe checkout
GET	/api/v1/billing/portal	Stripe portal
POST	/api/v1/billing/webhook	Stripe webhook