Docs

Public API docs for humans and agents.

The OpenAPI document is the contract, Scalar is the interactive reference, and these pages explain how to use the Austin-first API without guessing.

API referenceOpenAPI JSONAPI index

Submissions

Public submissions go into moderation, not straight into the event feed.

Write route

POST /api/v1/submissions

{
  "citySlug": "austin",
  "title": "East side weekly run club",
  "details": "A recurring east side run club with a public signup page, consistent weekly timing, and beginner-friendly pacing.",
  "sourceUrl": "https://example.com/run-club",
  "eventDate": "Every Wednesday at 6:30 PM",
  "locationHint": "East Austin",
  "submitterEmail": "andrew@example.com",
  "submitterName": "Andrew",
  "source": "api"
}

What happens next

  • The submission is written to the canonical submissions table.
  • A moderation queue item is created for review.
  • The response returns `submissionId` and `reviewQueueId` so downstream systems can track intake.