Codex Reset Feed API

openapi: 3.2.0
info:
  title: Codex Reset Com Feed API
  version: 1.0.0
  contact:
    name: codex-reset.com
    url: https://codex-reset.com/developers
  license:
    name: 'Data: CC BY 4.0 with credit to codex-reset.com'
    url: https://creativecommons.org/licenses/by/4.0/
  termsOfService: https://codex-reset.com/terms
  description: 'Operations tagged Feed across 2 of this provider''s published API definitions: codex-reset-com-openapi.json, codex-reset-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://codex-reset.com
security: []
tags:
- name: Feed
paths:
  /api/feed:
    get:
      operationId: getFeed
      summary: Tibo's recent posts
      description: 'The hot feed: posts a reset lane claims, display-only context posts, the site''s observed banked grants and the timeline rows. Classification envelopes and internal provenance are stripped.'
      parameters:
      - $ref: '#/components/parameters/locale'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Feed'
        '400':
          $ref: '#/components/responses/UnsupportedLocale'
      tags:
      - Feed
    servers:
    - url: https://codex-reset.com
components:
  parameters:
    locale:
      name: locale
      in: query
      schema:
        type: string
        enum:
        - zh
        - ja
        - es
      description: Adds translated copy (localized_summary, localized_text). Omit for English.
  schemas:
    BankedObservation:
      type: object
      description: A banked grant the site's own monitoring saw land.
      required:
      - id
      - kind
      - source
      - banked_state
      - at
      - after_announcement
      - title
      - text
      properties:
        id:
          type: string
          description: The Event id, not a post id.
        kind:
          const: banked
        source:
          const: observed
        banked_state:
          const: available
        at:
          type: string
          format: date-time
          description: Grant time.
        after_announcement:
          type: boolean
        title:
          type: string
        text:
          type: string
          description: The channel sentence, English.
    RadarContextPost:
      type: object
      description: 'A recent post no reset lane claims. Display-only: never an alert, reset or forecast input.'
      required:
      - id
      - text
      - at
      - url
      - display_kind
      - visibility_only
      properties:
        id:
          type: string
          pattern: ^[0-9]{5,25}$
          description: X post id.
        text:
          type: string
        at:
          type: string
          format: date-time
        url:
          type: string
          format: uri
        display_kind:
          const: context
        visibility_only:
          const: true
    Feed:
      type: object
      required:
      - fetched_at
      - source
      - stale
      - tweets
      - radar_context
      - banked_observations
      - events
      properties:
        fetched_at:
          type: string
          format: date-time
        source:
          type: string
        stale:
          type: boolean
        newest_post_at:
          anyOf:
          - type: string
            format: date-time
          - type: 'null'
        tweets:
          type: array
          items:
            $ref: '#/components/schemas/FeedPost'
        radar_context:
          type: array
          maxItems: 10
          items:
            $ref: '#/components/schemas/RadarContextPost'
          description: Newest posts of the last 14 days that no reset lane claims; tweets ∪ radar_context sorted by at is the raw recent timeline.
        banked_observations:
          type: array
          items:
            $ref: '#/components/schemas/BankedObservation'
          description: Newest first; always an array.
        events:
          type: array
          items:
            $ref: '#/components/schemas/TimelineEvent'
          description: The same rows as /api/timeline events.
    TimelineEvent:
      type: object
      required:
      - id
      - date
      - type
      - group
      - summary
      - announced_at
      properties:
        id:
          type: string
        date:
          type: string
          format: date
        type:
          type: string
        group:
          type: string
          enum:
          - reset
          - credits
          - boost
          - unlock
          description: credits = a banked grant or its update. /api/timeline returns only reset and credits; /api/feed events may still carry boost and unlock rows.
        summary:
          type: string
          description: ≤180-character excerpt, or the site's own summary for an observed row.
        text:
          type: string
          description: 'Credits rows: the full post.'
        localized_summary:
          type: string
        localized_text:
          type: string
        url:
          anyOf:
          - type: string
            format: uri
          - type: 'null'
        announced_at:
          type: string
          format: date-time
        announcement_state:
          type: string
          description: announced = ✅ for an ordinary reset.
        banked_state:
          type: string
          enum:
          - announced
          - arriving
          - available
          - unknown
        source:
          type: string
        observed_variant:
          type: string
        preview:
          type: boolean
        confirmed:
          type: boolean
          description: A reset row counts as a verified global reset; banked rows are true.
        banked_grant:
          type: boolean
          description: true on the row that is a banked grant; false on a grant's later updates.
    FeedPost:
      type: object
      description: One of Tibo's posts that a reset lane claims.
      required:
      - id
      - text
      - at
      - url
      - is_reply
      - tibo_lane
      - explicit_reset_claim
      properties:
        id:
          type: string
          pattern: ^[0-9]{5,25}$
          description: X post id.
        text:
          type: string
        at:
          type: string
          format: date-time
        url:
          type: string
          format: uri
        is_reply:
          type: boolean
        replying_to:
          anyOf:
          - type: string
          - type: 'null'
        tibo_lane:
          type: string
          enum:
          - reset_announcement
          - reset_related
        explicit_reset_claim:
          type: boolean
        banked_state:
          type: string
          enum:
          - announced
          - arriving
          - available
          - unknown
        separate_grant:
          type: boolean
          description: A banked row the site files as a grant of its own; never merge it with banked_observations.
        replies:
          type: integer
        reposts:
          type: integer
        likes:
          type: integer
  responses:
    UnsupportedLocale:
      description: The locale is not one of zh, ja, es.
      content:
        application/json:
          schema:
            type: object
            required:
            - error
            properties:
              error:
                const: unsupported_locale
externalDocs:
  description: Developer guide
  url: https://codex-reset.com/developers
x-refined-from:
- codex-reset-com-openapi.json
- codex-reset-com-openapi.yml