openapi: 3.0.1
info:
  title: PostArmory Public API
  description: Public REST API for PostArmory. The API can be used in standalone integrations and with agent frameworks such as Hermes and OpenClaw. It is intended for both developers and end users.
  version: "1.0.0"
servers:
  - url: https://www.postarmory.com/api
paths:
  /posts:
    get:
      operationId: listPosts
      summary: List posts
      description: Retrieve the authenticated user's posts.
      responses:
        "200":
          description: A list of posts.
    post:
      operationId: createPost
      summary: Create a post
      description: Create a new post.
      responses:
        "201":
          description: Post created.
  /posts/{post_id}:
    delete:
      operationId: deletePost
      summary: Delete a post
      description: Delete a post by ID.
      parameters:
        - name: post_id
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Post deleted.
  /posts/hermes/stats:
    get:
      operationId: getHermesStats
      summary: Get Hermes stats
      description: Retrieve Hermes-related statistics.
      responses:
        "200":
          description: Hermes statistics returned.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
security:
  - apiKeyAuth: []