openapi: 3.0.3
info:
  title: Growpost API
  description: >
    Public reference for the Growpost API. Today this covers service status only.
    Growpost's product surface (content generation, calendar, brand voice) is
    accessed through the web app at https://growpost.space and is not yet open
    for third-party integration. Partner API access is available on request —
    see the Developers page.
  version: "1.0"
  contact:
    name: Growpost
    email: hello@growpost.space
    url: https://growpost.space/developers
servers:
  - url: https://api.growpost.space
    description: Production API
paths:
  /health:
    get:
      summary: Service health check
      description: Returns 200 when the API is up. Public, unauthenticated.
      operationId: getHealth
      tags: [Status]
      responses:
        "200":
          description: Service is healthy
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: ok
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        Bearer token authentication, used by Growpost's first-party web and
        mobile clients. Not currently issued to third parties; contact
        hello@growpost.space for partner API access.