Hanging Context Policy API

openapi: 3.2.0
info:
  title: Hanging Context public read Policy API
  version: 1.0.0
  summary: Free, keyless JSON, Markdown and feeds for Hanging Context stories.
  description: 'Hanging Context publishes fresh context for agents. Stories are rebuilt every 12 hours. Each claim cites a Synorb Manifest. Every endpoint here is a read. No key is necessary. The same stories are also available through the MCP server at https://hangingcontext.com/mcp. Version policy: Breaking changes ship as a new version. We announce them at least 90 days ahead with Deprecation and Sunset response headers on the old version, and on the /developers page. Paging uses a cursor. Each REST list holds every story of its window, so the REST files have no cursor. To get only the stories that are new since your last call, call the MCP tool hc_since. It returns next_cursor and has_more, and you send next_cursor in your next call. Rate limit: 60 calls per 60 seconds per IP address for /ask and MCP tool calls.'
  termsOfService: https://hangingcontext.com/terms/reuse/
  contact:
    name: Hanging Context
    email: team@synorb.com
    url: https://hangingcontext.com/contact/
  license:
    name: Hanging Context reuse terms
    url: https://hangingcontext.com/terms/reuse/
  x-api-version: '1'
  x-sdks:
  - ecosystem: npm
    language: JavaScript
    package: hanging-context
    version: 0.1.0
    url: https://www.npmjs.com/package/hanging-context
    install: npm install hanging-context
    cli: hanging-context
  - ecosystem: pypi
    language: Python
    package: hanging-context
    version: 0.1.0
    url: https://pypi.org/project/hanging-context/
    install: pip install hanging-context
    cli: hanging-context
  x-pagination:
    style: cursor
    tool: hc_since
    cursor_field: next_cursor
    more_field: has_more
    note: Paging uses a cursor. Each REST list holds every story of its window, so the REST files have no cursor. To get only the stories that are new since your last call, call the MCP tool hc_since. It returns next_cursor and has_more, and you send next_cursor in your next call.
servers:
- url: https://hangingcontext.com
  description: Production
security: []
tags:
- name: Policy
  description: Reuse terms.
paths:
  /.well-known/reuse.json:
    get:
      operationId: getReuseTerms
      tags:
      - Policy
      summary: Get the reuse terms
      description: Get the reuse terms for stories in machine-readable form.
      responses:
        '200':
          description: The reuse terms.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReuseTerms'
          headers:
            HC-API-Version:
              $ref: '#/components/headers/HC-API-Version'
        '404':
          description: No such file. The body is JSON, Markdown or HTML, chosen by the Accept header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            text/markdown:
              schema:
                type: string
            text/html:
              schema:
                type: string
      parameters:
      - $ref: '#/components/parameters/ApiVersion'
components:
  schemas:
    ReuseTerms:
      type: object
      description: The reuse terms for stories.
      properties:
        version:
          type: string
        summary:
          type: string
        attribution:
          type: string
        link_rule:
          type: string
        keep_ids_rule:
          type: string
        no_endorsement:
          type: string
        license_url:
          type: string
          format: uri
        machine_url:
          type: string
          format: uri
      additionalProperties: true
    Error:
      type: object
      description: The JSON error body.
      required:
      - error
      - message
      properties:
        error:
          type: string
          description: A short error code.
          example: empty_question
        message:
          type: string
          description: What is wrong.
        next_step:
          type: string
          description: What to do next.
        retry_after:
          type: integer
          description: Seconds to wait. Only for code 429.
  headers:
    HC-API-Version:
      description: The API version of this response.
      schema:
        type: string
        example: '1'
  parameters:
    ApiVersion:
      name: HC-API-Version
      in: header
      required: false
      description: The API version you expect. Version 1 is the only version today. Every response carries the HC-API-Version header.
      schema:
        type: string
        enum:
        - '1'
        default: '1'
externalDocs:
  description: 'Hanging Context developers: the MCP server, the SDKs and the CLI, rate limits and errors.'
  url: https://hangingcontext.com/developers/