dialogbrain-com Reminders API

openapi: 3.2.0
info:
  title: DialogBrain v2 API Gateway Reminders API
  description: Clean refactored API gateway with minimal vertical slice
  version: 0.1.0
tags:
- name: Reminders
paths:
  /api/reminders/follow-up:
    get:
      tags:
      - Reminders
      summary: List Follow Up Reminders
      description: 'Get pending follow-up reminders for the current user.


        Returns threads where the user sent a message but hasn''t received

        a reply within the configured reminder period.'
      operationId: list_follow_up_reminders_api_reminders_follow_up_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 20
          title: Limit
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ReminderResponse'
                title: Response List Follow Up Reminders Api Reminders Follow Up Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/reminders/follow-up/{reminder_id}/dismiss:
    post:
      tags:
      - Reminders
      summary: Dismiss Follow Up Reminder
      description: 'Dismiss a follow-up reminder.


        Args:

        reminder_id: The reminder ID to dismiss

        request: Dismissal reason (manual, snoozed, etc.)'
      operationId: dismiss_follow_up_reminder_api_reminders_follow_up__reminder_id__dismiss_post
      parameters:
      - name: reminder_id
        in: path
        required: true
        schema:
          type: integer
          title: Reminder Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DismissRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/reminders/follow-up/count:
    get:
      tags:
      - Reminders
      summary: Get Follow Up Count
      description: 'Get the count of pending follow-up reminders.


        Useful for showing a badge or notification count.'
      operationId: get_follow_up_count_api_reminders_follow_up_count_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    ReminderResponse:
      properties:
        id:
          type: integer
          title: Id
        thread_id:
          type: integer
          title: Thread Id
        person_id:
          anyOf:
          - type: integer
          - type: 'null'
          title: Person Id
        last_outgoing_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Last Outgoing At
        thread_title:
          anyOf:
          - type: string
          - type: 'null'
          title: Thread Title
        contact_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Contact Name
        message_preview:
          anyOf:
          - type: string
          - type: 'null'
          title: Message Preview
        reminder_days:
          type: integer
          title: Reminder Days
        status:
          type: string
          title: Status
        notified_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Notified At
        created_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Created At
        days_waiting:
          anyOf:
          - type: integer
          - type: 'null'
          title: Days Waiting
      type: object
      required:
      - id
      - thread_id
      - reminder_days
      - status
      title: ReminderResponse
      description: Follow-up reminder response.
    DismissRequest:
      properties:
        reason:
          type: string
          title: Reason
          default: manual
      type: object
      title: DismissRequest
      description: Request to dismiss a reminder.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError