{
  "components": {
    "responses": {
      "Error401": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Missing or invalid authentication credentials."
      },
      "Error403": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Authenticated, but the token does not grant the required scope."
      },
      "Error404": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            }
          }
        },
        "description": "Requested resource was not found."
      }
    },
    "schemas": {
      "AIUserProfileResponse": {
        "properties": {
          "data_sources_used": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Sources Used"
          },
          "generated_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Generated At"
          },
          "profile_text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Text"
          }
        },
        "title": "AIUserProfileResponse",
        "type": "object"
      },
      "AcceptSharedActionItemsResponse": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "created": {
            "items": {
              "type": "string"
            },
            "title": "Created",
            "type": "array"
          }
        },
        "required": [
          "created",
          "count"
        ],
        "title": "AcceptSharedActionItemsResponse",
        "type": "object"
      },
      "AcceptSharedTasksRequest": {
        "properties": {
          "token": {
            "description": "Share token from the shared URL",
            "title": "Token",
            "type": "string"
          }
        },
        "required": [
          "token"
        ],
        "title": "AcceptSharedTasksRequest",
        "type": "object"
      },
      "Action": {
        "properties": {
          "action": {
            "$ref": "#/components/schemas/ActionType"
          }
        },
        "required": [
          "action"
        ],
        "title": "Action",
        "type": "object"
      },
      "ActionItem": {
        "properties": {
          "candidate_action": {
            "anyOf": [
              {
                "enum": [
                  "create",
                  "update",
                  "complete"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Candidate Action"
          },
          "capture_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capture Confidence"
          },
          "capture_kind": {
            "anyOf": [
              {
                "enum": [
                  "explicit_command",
                  "clear_commitment",
                  "direct_request",
                  "inferred_next_step"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capture Kind"
          },
          "capture_owner": {
            "anyOf": [
              {
                "enum": [
                  "user",
                  "other",
                  "unknown"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capture Owner"
          },
          "completed": {
            "default": false,
            "title": "Completed",
            "type": "boolean"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the action item was completed",
            "title": "Completed At"
          },
          "concrete_deliverable": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True only when the commitment names a concrete deliverable or outcome",
            "title": "Concrete Deliverable"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID of the conversation this action item came from",
            "title": "Conversation Id"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the action item was created",
            "title": "Created At"
          },
          "description": {
            "description": "The action item to be completed",
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the action item is due",
            "title": "Due At"
          },
          "ownership_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ownership Confidence"
          },
          "target_task_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Task Id"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the action item was last updated",
            "title": "Updated At"
          }
        },
        "required": [
          "description"
        ],
        "title": "ActionItem",
        "type": "object"
      },
      "ActionItemCreateRequest": {
        "description": "Released-client adapter; unknown historical fields remain ignored at this route boundary.",
        "properties": {
          "apple_reminder_id": {
            "anyOf": [
              {
                "maxLength": 512,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Apple Reminder Id"
          },
          "completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed"
          },
          "conversation_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "description": {
            "maxLength": 4096,
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "due_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due Confidence"
          },
          "export_date": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Date"
          },
          "export_platform": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Platform"
          },
          "exported": {
            "default": false,
            "title": "Exported",
            "type": "boolean"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "indent_level": {
            "default": 0,
            "maximum": 3,
            "minimum": 0,
            "title": "Indent Level",
            "type": "integer"
          },
          "is_locked": {
            "default": false,
            "title": "Is Locked",
            "type": "boolean"
          },
          "owner": {
            "$ref": "#/components/schemas/TaskOwner",
            "default": "user"
          },
          "priority": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskPriority"
              },
              {
                "type": "null"
              }
            ]
          },
          "provenance": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "title": "Provenance",
            "type": "array"
          },
          "recurrence_parent_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Parent Id"
          },
          "recurrence_rule": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Rule"
          },
          "sort_order": {
            "default": 0,
            "title": "Sort Order",
            "type": "integer"
          },
          "source": {
            "default": "manual",
            "maxLength": 64,
            "minLength": 1,
            "title": "Source",
            "type": "string"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "description"
        ],
        "title": "ActionItemCreateRequest",
        "type": "object"
      },
      "ActionItemIdsResponse": {
        "properties": {
          "ids": {
            "items": {
              "type": "string"
            },
            "title": "Ids",
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "title": "ActionItemIdsResponse",
        "type": "object"
      },
      "ActionItemResponse": {
        "description": "Canonical response plus stable fields required by deployed old clients.",
        "properties": {
          "apple_reminder_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Apple Reminder Id"
          },
          "completed": {
            "title": "Completed",
            "type": "boolean"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "due_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due Confidence"
          },
          "export_date": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Date"
          },
          "export_platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Platform"
          },
          "exported": {
            "default": false,
            "title": "Exported",
            "type": "boolean"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Id",
            "type": "string"
          },
          "indent_level": {
            "default": 0,
            "title": "Indent Level",
            "type": "integer"
          },
          "is_locked": {
            "default": false,
            "title": "Is Locked",
            "type": "boolean"
          },
          "owner": {
            "$ref": "#/components/schemas/TaskOwner",
            "default": "unknown"
          },
          "priority": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskPriority"
              },
              {
                "type": "null"
              }
            ]
          },
          "provenance": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "title": "Provenance",
            "type": "array"
          },
          "recurrence_parent_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Parent Id"
          },
          "recurrence_rule": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Rule"
          },
          "sort_order": {
            "default": 0,
            "title": "Sort Order",
            "type": "integer"
          },
          "source": {
            "default": "legacy",
            "title": "Source",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/TaskStatus",
            "default": "active"
          },
          "superseded_by": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Superseded By"
          },
          "task_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Task Id"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "id",
          "description",
          "completed"
        ],
        "title": "ActionItemResponse",
        "type": "object"
      },
      "ActionItemUpdateRequest": {
        "description": "Released-client adapter with the desktop's explicit due-date clearing flag.",
        "properties": {
          "apple_reminder_id": {
            "anyOf": [
              {
                "maxLength": 512,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Apple Reminder Id"
          },
          "clear_due_at": {
            "default": false,
            "title": "Clear Due At",
            "type": "boolean"
          },
          "completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed"
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 4096,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "due_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due Confidence"
          },
          "export_date": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Date"
          },
          "export_platform": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Platform"
          },
          "exported": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Exported"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "indent_level": {
            "anyOf": [
              {
                "maximum": 3,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Indent Level"
          },
          "owner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskOwner"
              },
              {
                "type": "null"
              }
            ]
          },
          "priority": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskPriority"
              },
              {
                "type": "null"
              }
            ]
          },
          "provenance": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/EvidenceRef"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Provenance"
          },
          "recurrence_parent_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Parent Id"
          },
          "recurrence_rule": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Rule"
          },
          "sort_order": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sort Order"
          },
          "source": {
            "anyOf": [
              {
                "maxLength": 64,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "superseded_by": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Superseded By"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "title": "ActionItemUpdateRequest",
        "type": "object"
      },
      "ActionItemsResponse": {
        "properties": {
          "action_items": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Action Items",
            "type": "array"
          },
          "has_more": {
            "default": false,
            "title": "Has More",
            "type": "boolean"
          }
        },
        "required": [
          "action_items"
        ],
        "title": "ActionItemsResponse",
        "type": "object"
      },
      "ActionItemsSearchResponse": {
        "properties": {
          "action_items": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Action Items",
            "type": "array"
          }
        },
        "required": [
          "action_items"
        ],
        "title": "ActionItemsSearchResponse",
        "type": "object"
      },
      "ActionType": {
        "enum": [
          "create_conversation",
          "create_facts",
          "read_memories",
          "read_conversations",
          "read_tasks"
        ],
        "title": "ActionType",
        "type": "string"
      },
      "AddTesterRequest": {
        "additionalProperties": true,
        "properties": {
          "apps": {
            "items": {
              "type": "string"
            },
            "title": "Apps",
            "type": "array"
          },
          "uid": {
            "title": "Uid",
            "type": "string"
          }
        },
        "required": [
          "uid",
          "apps"
        ],
        "title": "AddTesterRequest",
        "type": "object"
      },
      "AdviceAssistantSettings": {
        "properties": {
          "analysis_prompt": {
            "anyOf": [
              {
                "maxLength": 10000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysis Prompt"
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "excluded_apps": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excluded Apps"
          },
          "extraction_interval": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Extraction Interval"
          },
          "min_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Confidence"
          },
          "notifications_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notifications Enabled"
          }
        },
        "title": "AdviceAssistantSettings",
        "type": "object"
      },
      "AdviceResponse": {
        "properties": {
          "advice": {
            "title": "Advice",
            "type": "string"
          }
        },
        "required": [
          "advice"
        ],
        "title": "AdviceResponse",
        "type": "object"
      },
      "AgentKeepaliveResponse": {
        "properties": {
          "ok": {
            "title": "Ok",
            "type": "boolean"
          },
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          }
        },
        "required": [
          "ok"
        ],
        "title": "AgentKeepaliveResponse",
        "type": "object"
      },
      "AgentToolSchema": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "parameters": {
            "additionalProperties": true,
            "title": "Parameters",
            "type": "object"
          }
        },
        "required": [
          "name",
          "description",
          "parameters"
        ],
        "title": "AgentToolSchema",
        "type": "object"
      },
      "AgentToolsResponse": {
        "properties": {
          "tools": {
            "items": {
              "$ref": "#/components/schemas/AgentToolSchema"
            },
            "title": "Tools",
            "type": "array"
          }
        },
        "required": [
          "tools"
        ],
        "title": "AgentToolsResponse",
        "type": "object"
      },
      "AgentVmInfo": {
        "properties": {
          "has_vm": {
            "title": "Has Vm",
            "type": "boolean"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          }
        },
        "required": [
          "has_vm"
        ],
        "title": "AgentVmInfo",
        "type": "object"
      },
      "Announcement": {
        "properties": {
          "active": {
            "default": true,
            "title": "Active",
            "type": "boolean"
          },
          "app_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Version"
          },
          "content": {
            "additionalProperties": true,
            "title": "Content",
            "type": "object"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "device_models": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Models"
          },
          "display": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Display"
              },
              {
                "type": "null"
              }
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "firmware_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Firmware Version"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "targeting": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Targeting"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "$ref": "#/components/schemas/AnnouncementType"
          }
        },
        "required": [
          "id",
          "type",
          "created_at",
          "content"
        ],
        "title": "Announcement",
        "type": "object"
      },
      "AnnouncementDeleteResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success",
          "message"
        ],
        "title": "AnnouncementDeleteResponse",
        "type": "object"
      },
      "AnnouncementType": {
        "enum": [
          "changelog",
          "feature",
          "announcement"
        ],
        "title": "AnnouncementType",
        "type": "string"
      },
      "App": {
        "description": "Full App model - includes large/internal fields for detail views.",
        "properties": {
          "approved": {
            "default": false,
            "title": "Approved",
            "type": "boolean"
          },
          "author": {
            "title": "Author",
            "type": "string"
          },
          "capabilities": {
            "items": {
              "type": "string"
            },
            "title": "Capabilities",
            "type": "array",
            "uniqueItems": true
          },
          "category": {
            "title": "Category",
            "type": "string"
          },
          "chat_prompt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Prompt"
          },
          "chat_tools": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/ChatTool"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Tools"
          },
          "connected_accounts": {
            "items": {
              "type": "string"
            },
            "title": "Connected Accounts",
            "type": "array"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "disabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Disabled"
          },
          "disabled_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Disabled Reason"
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "enabled": {
            "default": false,
            "title": "Enabled",
            "type": "boolean"
          },
          "external_integration": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ExternalIntegration"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "image": {
            "title": "Image",
            "type": "string"
          },
          "installs": {
            "default": 0,
            "title": "Installs",
            "type": "integer"
          },
          "is_influencer": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Influencer"
          },
          "is_paid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Paid"
          },
          "is_popular": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Popular"
          },
          "is_user_paid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is User Paid"
          },
          "memory_prompt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Memory Prompt"
          },
          "money_made": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Money Made"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "official": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Official"
          },
          "payment_link": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Link"
          },
          "payment_link_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Link Id"
          },
          "payment_plan": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Plan"
          },
          "payment_price_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Price Id"
          },
          "payment_product_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Product Id"
          },
          "persona_prompt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Persona Prompt"
          },
          "price": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": 0,
            "title": "Price"
          },
          "private": {
            "default": false,
            "title": "Private",
            "type": "boolean"
          },
          "proactive_notification": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ProactiveNotification"
              },
              {
                "type": "null"
              }
            ]
          },
          "rating_avg": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": 0,
            "title": "Rating Avg"
          },
          "rating_count": {
            "default": 0,
            "title": "Rating Count",
            "type": "integer"
          },
          "reviews": {
            "items": {
              "$ref": "#/components/schemas/AppReview"
            },
            "title": "Reviews",
            "type": "array"
          },
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "source_code_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Code Url"
          },
          "status": {
            "default": "approved",
            "title": "Status",
            "type": "string"
          },
          "thumbnail_urls": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnail Urls"
          },
          "thumbnails": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnails"
          },
          "trigger_workflow_memories": {
            "default": true,
            "title": "Trigger Workflow Memories",
            "type": "boolean"
          },
          "twitter": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter"
          },
          "uid": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Uid"
          },
          "usage_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Usage Count"
          },
          "user_review": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppReview"
              },
              {
                "type": "null"
              }
            ]
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "id",
          "name",
          "category",
          "author",
          "description",
          "image",
          "capabilities"
        ],
        "title": "App",
        "type": "object"
      },
      "AppApiKeyResponse": {
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "label": {
            "title": "Label",
            "type": "string"
          },
          "secret": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Secret"
          }
        },
        "required": [
          "id",
          "label"
        ],
        "title": "AppApiKeyResponse",
        "type": "object"
      },
      "AppBaseModel": {
        "description": "Base App model for list views - contains common fields only.",
        "properties": {
          "approved": {
            "default": false,
            "title": "Approved",
            "type": "boolean"
          },
          "author": {
            "title": "Author",
            "type": "string"
          },
          "capabilities": {
            "items": {
              "type": "string"
            },
            "title": "Capabilities",
            "type": "array",
            "uniqueItems": true
          },
          "category": {
            "title": "Category",
            "type": "string"
          },
          "chat_tools": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/ChatTool"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Tools"
          },
          "connected_accounts": {
            "items": {
              "type": "string"
            },
            "title": "Connected Accounts",
            "type": "array"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "disabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Disabled"
          },
          "disabled_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Disabled Reason"
          },
          "enabled": {
            "default": false,
            "title": "Enabled",
            "type": "boolean"
          },
          "external_integration": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ExternalIntegration"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "image": {
            "title": "Image",
            "type": "string"
          },
          "installs": {
            "default": 0,
            "title": "Installs",
            "type": "integer"
          },
          "is_influencer": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Influencer"
          },
          "is_paid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Paid"
          },
          "is_popular": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Popular"
          },
          "is_user_paid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is User Paid"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "official": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Official"
          },
          "payment_link": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Link"
          },
          "payment_plan": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Payment Plan"
          },
          "price": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": 0,
            "title": "Price"
          },
          "private": {
            "default": false,
            "title": "Private",
            "type": "boolean"
          },
          "proactive_notification": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ProactiveNotification"
              },
              {
                "type": "null"
              }
            ]
          },
          "rating_avg": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": 0,
            "title": "Rating Avg"
          },
          "rating_count": {
            "default": 0,
            "title": "Rating Count",
            "type": "integer"
          },
          "score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "source_code_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Code Url"
          },
          "status": {
            "default": "approved",
            "title": "Status",
            "type": "string"
          },
          "thumbnail_urls": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnail Urls"
          },
          "thumbnails": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Thumbnails"
          },
          "trigger_workflow_memories": {
            "default": true,
            "title": "Trigger Workflow Memories",
            "type": "boolean"
          },
          "uid": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Uid"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "id",
          "name",
          "category",
          "author",
          "description",
          "image",
          "capabilities"
        ],
        "title": "AppBaseModel",
        "type": "object"
      },
      "AppCapabilityAction": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "doc_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Doc Url"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "id"
        ],
        "title": "AppCapabilityAction",
        "type": "object"
      },
      "AppCapabilityResponse": {
        "properties": {
          "actions": {
            "items": {
              "$ref": "#/components/schemas/AppCapabilityAction"
            },
            "title": "Actions",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "scopes": {
            "items": {
              "$ref": "#/components/schemas/AppSelectOption"
            },
            "title": "Scopes",
            "type": "array"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "triggers": {
            "items": {
              "$ref": "#/components/schemas/AppSelectOption"
            },
            "title": "Triggers",
            "type": "array"
          }
        },
        "required": [
          "title",
          "id"
        ],
        "title": "AppCapabilityResponse",
        "type": "object"
      },
      "AppCatalogGroup": {
        "properties": {
          "capability": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppSelectOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppSelectOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Count"
          },
          "data": {
            "items": {
              "$ref": "#/components/schemas/AppCatalogItem"
            },
            "title": "Data",
            "type": "array"
          },
          "pagination": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppPagination"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "AppCatalogGroup",
        "type": "object"
      },
      "AppCatalogItem": {
        "description": "Desktop app catalog response item for list/search views.",
        "properties": {
          "approved": {
            "default": false,
            "title": "Approved",
            "type": "boolean"
          },
          "author": {
            "default": "",
            "title": "Author",
            "type": "string"
          },
          "capabilities": {
            "items": {
              "type": "string"
            },
            "title": "Capabilities",
            "type": "array"
          },
          "category": {
            "default": "other",
            "title": "Category",
            "type": "string"
          },
          "description": {
            "default": "",
            "title": "Description",
            "type": "string"
          },
          "enabled": {
            "default": false,
            "title": "Enabled",
            "type": "boolean"
          },
          "external_integration": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ExternalIntegration"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "image": {
            "default": "",
            "title": "Image",
            "type": "string"
          },
          "installs": {
            "default": 0,
            "title": "Installs",
            "type": "integer"
          },
          "is_paid": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Is Paid"
          },
          "name": {
            "default": "",
            "title": "Name",
            "type": "string"
          },
          "price": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Price"
          },
          "private": {
            "default": false,
            "title": "Private",
            "type": "boolean"
          },
          "rating_avg": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rating Avg"
          },
          "rating_count": {
            "default": 0,
            "title": "Rating Count",
            "type": "integer"
          },
          "status": {
            "default": "approved",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "title": "AppCatalogItem",
        "type": "object"
      },
      "AppCatalogMeta": {
        "properties": {
          "capabilities": {
            "items": {
              "$ref": "#/components/schemas/AppSelectOption"
            },
            "title": "Capabilities",
            "type": "array"
          },
          "groupCount": {
            "default": 0,
            "title": "Groupcount",
            "type": "integer"
          },
          "limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limit"
          },
          "offset": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Offset"
          },
          "totalApps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Totalapps"
          }
        },
        "title": "AppCatalogMeta",
        "type": "object"
      },
      "AppCatalogResponse": {
        "properties": {
          "capability": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppSelectOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppSelectOption"
              },
              {
                "type": "null"
              }
            ]
          },
          "data": {
            "items": {
              "$ref": "#/components/schemas/AppCatalogItem"
            },
            "title": "Data",
            "type": "array"
          },
          "groups": {
            "items": {
              "$ref": "#/components/schemas/AppCatalogGroup"
            },
            "title": "Groups",
            "type": "array"
          },
          "meta": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppCatalogMeta"
              },
              {
                "type": "null"
              }
            ]
          },
          "pagination": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppPagination"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "AppCatalogResponse",
        "type": "object"
      },
      "AppCreateResponse": {
        "properties": {
          "app_id": {
            "title": "App Id",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "app_id"
        ],
        "title": "AppCreateResponse",
        "type": "object"
      },
      "AppDescriptionEmojiGenerationResponse": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          },
          "emoji": {
            "title": "Emoji",
            "type": "string"
          }
        },
        "required": [
          "description",
          "emoji"
        ],
        "title": "AppDescriptionEmojiGenerationResponse",
        "type": "object"
      },
      "AppDescriptionGenerationResponse": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          }
        },
        "required": [
          "description"
        ],
        "title": "AppDescriptionGenerationResponse",
        "type": "object"
      },
      "AppDraftGenerationResponse": {
        "properties": {
          "capabilities": {
            "items": {
              "type": "string"
            },
            "title": "Capabilities",
            "type": "array"
          },
          "category": {
            "title": "Category",
            "type": "string"
          },
          "chat_prompt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Prompt"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "memory_prompt": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Memory Prompt"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name",
          "description",
          "category",
          "capabilities"
        ],
        "title": "AppDraftGenerationResponse",
        "type": "object"
      },
      "AppGenerationResponse": {
        "properties": {
          "app": {
            "$ref": "#/components/schemas/AppDraftGenerationResponse"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "app"
        ],
        "title": "AppGenerationResponse",
        "type": "object"
      },
      "AppIconGenerationResponse": {
        "properties": {
          "icon_base64": {
            "title": "Icon Base64",
            "type": "string"
          },
          "mime_type": {
            "title": "Mime Type",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "icon_base64",
          "mime_type"
        ],
        "title": "AppIconGenerationResponse",
        "type": "object"
      },
      "AppManifestRefreshResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          },
          "tools_count": {
            "default": 0,
            "title": "Tools Count",
            "type": "integer"
          }
        },
        "required": [
          "status"
        ],
        "title": "AppManifestRefreshResponse",
        "type": "object"
      },
      "AppMigrationResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message"
        ],
        "title": "AppMigrationResponse",
        "type": "object"
      },
      "AppMutationResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "AppMutationResponse",
        "type": "object"
      },
      "AppPagination": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "hasNext": {
            "title": "Hasnext",
            "type": "boolean"
          },
          "hasPrevious": {
            "title": "Hasprevious",
            "type": "boolean"
          },
          "limit": {
            "title": "Limit",
            "type": "integer"
          },
          "links": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppPaginationLinks"
              },
              {
                "type": "null"
              }
            ]
          },
          "offset": {
            "title": "Offset",
            "type": "integer"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "total",
          "count",
          "offset",
          "limit",
          "hasNext",
          "hasPrevious"
        ],
        "title": "AppPagination",
        "type": "object"
      },
      "AppPaginationLinks": {
        "properties": {
          "next": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next"
          },
          "previous": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous"
          }
        },
        "title": "AppPaginationLinks",
        "type": "object"
      },
      "AppPromptsGenerationResponse": {
        "properties": {
          "prompts": {
            "items": {
              "type": "string"
            },
            "title": "Prompts",
            "type": "array"
          }
        },
        "required": [
          "prompts"
        ],
        "title": "AppPromptsGenerationResponse",
        "type": "object"
      },
      "AppResult": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "content": {
            "title": "Content",
            "type": "string"
          }
        },
        "required": [
          "app_id",
          "content"
        ],
        "title": "AppResult",
        "type": "object"
      },
      "AppReview": {
        "properties": {
          "rated_at": {
            "format": "date-time",
            "title": "Rated At",
            "type": "string"
          },
          "responded_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Responded At"
          },
          "response": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Response"
          },
          "review": {
            "title": "Review",
            "type": "string"
          },
          "score": {
            "title": "Score",
            "type": "number"
          },
          "uid": {
            "title": "Uid",
            "type": "string"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "uid",
          "rated_at",
          "score",
          "review"
        ],
        "title": "AppReview",
        "type": "object"
      },
      "AppSearchFilters": {
        "properties": {
          "capability": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Capability"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "installed_apps": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Installed Apps"
          },
          "my_apps": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "My Apps"
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Query"
          },
          "rating": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rating"
          },
          "sort": {
            "title": "Sort",
            "type": "string"
          }
        },
        "required": [
          "sort"
        ],
        "title": "AppSearchFilters",
        "type": "object"
      },
      "AppSearchResponse": {
        "properties": {
          "data": {
            "items": {
              "$ref": "#/components/schemas/AppCatalogItem"
            },
            "title": "Data",
            "type": "array"
          },
          "filters": {
            "$ref": "#/components/schemas/AppSearchFilters"
          },
          "pagination": {
            "$ref": "#/components/schemas/AppPagination"
          }
        },
        "required": [
          "pagination",
          "filters"
        ],
        "title": "AppSearchResponse",
        "type": "object"
      },
      "AppSelectOption": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "id"
        ],
        "title": "AppSelectOption",
        "type": "object"
      },
      "AppStatusMessageResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message"
        ],
        "title": "AppStatusMessageResponse",
        "type": "object"
      },
      "AppSubscriptionCancelResponse": {
        "properties": {
          "cancel_at_period_end": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cancel At Period End"
          },
          "current_period_end": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period End"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message"
        ],
        "title": "AppSubscriptionCancelResponse",
        "type": "object"
      },
      "AppSubscriptionDetails": {
        "properties": {
          "cancel_at_period_end": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cancel At Period End"
          },
          "current_period_end": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period End"
          },
          "customer_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Customer Id"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "price_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Price Id"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          }
        },
        "title": "AppSubscriptionDetails",
        "type": "object"
      },
      "AppSubscriptionResponse": {
        "properties": {
          "subscription": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AppSubscriptionDetails"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "AppSubscriptionResponse",
        "type": "object"
      },
      "AppTesterCheckResponse": {
        "properties": {
          "is_tester": {
            "title": "Is Tester",
            "type": "boolean"
          }
        },
        "required": [
          "is_tester"
        ],
        "title": "AppTesterCheckResponse",
        "type": "object"
      },
      "AppThumbnailUploadResponse": {
        "properties": {
          "thumbnail_id": {
            "title": "Thumbnail Id",
            "type": "string"
          },
          "thumbnail_url": {
            "title": "Thumbnail Url",
            "type": "string"
          }
        },
        "required": [
          "thumbnail_url",
          "thumbnail_id"
        ],
        "title": "AppThumbnailUploadResponse",
        "type": "object"
      },
      "AppleHealthSyncData": {
        "description": "Health data synced from Apple Health on iOS device",
        "properties": {
          "average_active_energy_per_day": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average daily active energy",
            "title": "Average Active Energy Per Day"
          },
          "average_steps_per_day": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average steps per day",
            "title": "Average Steps Per Day"
          },
          "daily_active_energy": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Daily energy breakdown [{date, calories}]",
            "title": "Daily Active Energy"
          },
          "daily_sleep": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Daily sleep breakdown [{date, sleepHours}]",
            "title": "Daily Sleep"
          },
          "daily_steps": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Daily steps breakdown [{date, steps}]",
            "title": "Daily Steps"
          },
          "heart_rate_average": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Average heart rate",
            "title": "Heart Rate Average"
          },
          "heart_rate_max": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Maximum heart rate",
            "title": "Heart Rate Max"
          },
          "heart_rate_min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Minimum heart rate",
            "title": "Heart Rate Min"
          },
          "period_days": {
            "default": 7,
            "description": "Number of days of data",
            "title": "Period Days",
            "type": "integer"
          },
          "sleep_sessions": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "Sleep session details",
            "title": "Sleep Sessions"
          },
          "sleep_sessions_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Number of sleep sessions",
            "title": "Sleep Sessions Count"
          },
          "total_active_energy": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total active energy kcal",
            "title": "Total Active Energy"
          },
          "total_in_bed_hours": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total time in bed hours",
            "title": "Total In Bed Hours"
          },
          "total_sleep_hours": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total sleep hours",
            "title": "Total Sleep Hours"
          },
          "total_steps": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total steps in period",
            "title": "Total Steps"
          },
          "workouts": {
            "anyOf": [
              {
                "items": {
                  "additionalProperties": true,
                  "type": "object"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "List of workout records",
            "title": "Workouts"
          }
        },
        "title": "AppleHealthSyncData",
        "type": "object"
      },
      "AppleHealthSyncResponse": {
        "properties": {
          "app_key": {
            "title": "App Key",
            "type": "string"
          },
          "data_types_synced": {
            "items": {
              "type": "string"
            },
            "title": "Data Types Synced",
            "type": "array"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "synced_at": {
            "title": "Synced At",
            "type": "string"
          }
        },
        "required": [
          "status",
          "app_key",
          "synced_at"
        ],
        "title": "AppleHealthSyncResponse",
        "type": "object"
      },
      "ArtifactDescriptor": {
        "additionalProperties": false,
        "properties": {
          "artifact_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Artifact Id",
            "type": "string"
          },
          "content_hash": {
            "maxLength": 128,
            "minLength": 16,
            "title": "Content Hash",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "evidence_event_ids": {
            "items": {
              "maxLength": 128,
              "minLength": 1,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
              "type": "string"
            },
            "maxItems": 100,
            "title": "Evidence Event Ids",
            "type": "array"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "kind": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Kind",
            "type": "string"
          },
          "logical_key": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Logical Key",
            "type": "string"
          },
          "source_run_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Run Id"
          },
          "status": {
            "$ref": "#/components/schemas/ArtifactStatus",
            "default": "draft"
          },
          "supersedes_artifact_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Supersedes Artifact Id"
          },
          "uri": {
            "maxLength": 2048,
            "minLength": 1,
            "title": "Uri",
            "type": "string"
          },
          "version": {
            "minimum": 1,
            "title": "Version",
            "type": "integer"
          },
          "workstream_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Workstream Id",
            "type": "string"
          }
        },
        "required": [
          "logical_key",
          "version",
          "kind",
          "uri",
          "content_hash",
          "artifact_id",
          "workstream_id",
          "created_at"
        ],
        "title": "ArtifactDescriptor",
        "type": "object"
      },
      "ArtifactDescriptorCreate": {
        "additionalProperties": false,
        "properties": {
          "content_hash": {
            "maxLength": 128,
            "minLength": 16,
            "title": "Content Hash",
            "type": "string"
          },
          "evidence_event_ids": {
            "items": {
              "maxLength": 128,
              "minLength": 1,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
              "type": "string"
            },
            "maxItems": 100,
            "title": "Evidence Event Ids",
            "type": "array"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "kind": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Kind",
            "type": "string"
          },
          "logical_key": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Logical Key",
            "type": "string"
          },
          "source_run_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Run Id"
          },
          "supersedes_artifact_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Supersedes Artifact Id"
          },
          "uri": {
            "maxLength": 2048,
            "minLength": 1,
            "title": "Uri",
            "type": "string"
          },
          "version": {
            "minimum": 1,
            "title": "Version",
            "type": "integer"
          }
        },
        "required": [
          "logical_key",
          "version",
          "kind",
          "uri",
          "content_hash"
        ],
        "title": "ArtifactDescriptorCreate",
        "type": "object"
      },
      "ArtifactStatus": {
        "enum": [
          "draft",
          "awaiting_review",
          "approved",
          "delivered",
          "superseded"
        ],
        "title": "ArtifactStatus",
        "type": "string"
      },
      "ArtifactStatusTransitionRequest": {
        "additionalProperties": false,
        "properties": {
          "status": {
            "$ref": "#/components/schemas/ArtifactStatus"
          }
        },
        "required": [
          "status"
        ],
        "title": "ArtifactStatusTransitionRequest",
        "type": "object"
      },
      "AsanaProjectsResponse": {
        "properties": {
          "projects": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Projects",
            "type": "array"
          }
        },
        "title": "AsanaProjectsResponse",
        "type": "object"
      },
      "AsanaWorkspacesResponse": {
        "properties": {
          "workspaces": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Workspaces",
            "type": "array"
          }
        },
        "title": "AsanaWorkspacesResponse",
        "type": "object"
      },
      "AssistantSettingsResponse": {
        "additionalProperties": true,
        "properties": {
          "advice": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AdviceAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "floating_bar": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FloatingBarSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "focus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FocusAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "memory": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MemoryAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "shared": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SharedAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "task": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "update_channel": {
            "anyOf": [
              {
                "maxLength": 50,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Update Channel"
          }
        },
        "title": "AssistantSettingsResponse",
        "type": "object"
      },
      "AudioDownloadPendingResponse": {
        "properties": {
          "poll_after_ms": {
            "title": "Poll After Ms",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "poll_after_ms"
        ],
        "title": "AudioDownloadPendingResponse",
        "type": "object"
      },
      "AudioFile": {
        "properties": {
          "chunk_timestamps": {
            "description": "List of chunk timestamps (for on-demand merging)",
            "items": {
              "type": "number"
            },
            "title": "Chunk Timestamps",
            "type": "array"
          },
          "conversation_id": {
            "description": "ID of the conversation this audio belongs to",
            "title": "Conversation Id",
            "type": "string"
          },
          "duration": {
            "description": "Duration in seconds",
            "title": "Duration",
            "type": "number"
          },
          "id": {
            "description": "Unique identifier for the audio file",
            "title": "Id",
            "type": "string"
          },
          "provider": {
            "default": "gcp",
            "description": "Storage provider (e.g., 'gcp')",
            "title": "Provider",
            "type": "string"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When this audio file started (absolute timestamp)",
            "title": "Started At"
          },
          "uid": {
            "description": "User ID who owns this audio file",
            "title": "Uid",
            "type": "string"
          }
        },
        "required": [
          "id",
          "uid",
          "conversation_id",
          "chunk_timestamps",
          "duration"
        ],
        "title": "AudioFile",
        "type": "object"
      },
      "AudioFileUrlInfo": {
        "properties": {
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "duration": {
            "default": 0,
            "title": "Duration",
            "type": "number"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "signed_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Signed Url"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "title": "AudioFileUrlInfo",
        "type": "object"
      },
      "AudioPrecacheResponse": {
        "properties": {
          "audio_file_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Audio File Count"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "AudioPrecacheResponse",
        "type": "object"
      },
      "AudioUrlsResponse": {
        "properties": {
          "audio_files": {
            "items": {
              "$ref": "#/components/schemas/AudioFileUrlInfo"
            },
            "title": "Audio Files",
            "type": "array"
          },
          "conversation_audio": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationAudioUrlInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "poll_after_ms": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Poll After Ms"
          }
        },
        "required": [
          "audio_files"
        ],
        "title": "AudioUrlsResponse",
        "type": "object"
      },
      "AuthStep": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "name",
          "url"
        ],
        "title": "AuthStep",
        "type": "object"
      },
      "AvailablePlansResponse": {
        "properties": {
          "plans": {
            "items": {
              "$ref": "#/components/schemas/routers__payment__PricingOption"
            },
            "title": "Plans",
            "type": "array"
          }
        },
        "required": [
          "plans"
        ],
        "title": "AvailablePlansResponse",
        "type": "object"
      },
      "BYOKActivateRequest": {
        "properties": {
          "fingerprints": {
            "additionalProperties": {
              "type": "string"
            },
            "title": "Fingerprints",
            "type": "object"
          }
        },
        "required": [
          "fingerprints"
        ],
        "title": "BYOKActivateRequest",
        "type": "object"
      },
      "BYOKActiveResponse": {
        "properties": {
          "active": {
            "title": "Active",
            "type": "boolean"
          }
        },
        "required": [
          "active"
        ],
        "title": "BYOKActiveResponse",
        "type": "object"
      },
      "BatchActionItemsRequest": {
        "properties": {
          "action_items": {
            "description": "List of action items to create",
            "items": {
              "$ref": "#/components/schemas/CreateActionItemRequest"
            },
            "maxItems": 50,
            "title": "Action Items",
            "type": "array"
          }
        },
        "required": [
          "action_items"
        ],
        "title": "BatchActionItemsRequest",
        "type": "object"
      },
      "BatchActionItemsResponse": {
        "properties": {
          "action_items": {
            "items": {
              "$ref": "#/components/schemas/DeveloperActionItem"
            },
            "title": "Action Items",
            "type": "array"
          },
          "created_count": {
            "title": "Created Count",
            "type": "integer"
          }
        },
        "required": [
          "action_items",
          "created_count"
        ],
        "title": "BatchActionItemsResponse",
        "type": "object"
      },
      "BatchCreateActionItemsResponse": {
        "properties": {
          "action_items": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Action Items",
            "type": "array"
          },
          "created_count": {
            "title": "Created Count",
            "type": "integer"
          }
        },
        "required": [
          "action_items",
          "created_count"
        ],
        "title": "BatchCreateActionItemsResponse",
        "type": "object"
      },
      "BatchDeleteActionItemsRequest": {
        "properties": {
          "ids": {
            "description": "IDs of action items to delete",
            "items": {
              "type": "string"
            },
            "maxItems": 10000,
            "minItems": 1,
            "title": "Ids",
            "type": "array"
          }
        },
        "required": [
          "ids"
        ],
        "title": "BatchDeleteActionItemsRequest",
        "type": "object"
      },
      "BatchDeleteActionItemsResponse": {
        "properties": {
          "deleted_count": {
            "title": "Deleted Count",
            "type": "integer"
          },
          "deleted_ids": {
            "items": {
              "type": "string"
            },
            "title": "Deleted Ids",
            "type": "array"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "deleted_count",
          "deleted_ids"
        ],
        "title": "BatchDeleteActionItemsResponse",
        "type": "object"
      },
      "BatchMemoriesRequest": {
        "properties": {
          "memories": {
            "description": "List of memories to create",
            "items": {
              "$ref": "#/components/schemas/CreateMemoryRequest"
            },
            "maxItems": 25,
            "title": "Memories",
            "type": "array"
          }
        },
        "required": [
          "memories"
        ],
        "title": "BatchMemoriesRequest",
        "type": "object"
      },
      "BatchMemoriesResponse": {
        "properties": {
          "created_count": {
            "title": "Created Count",
            "type": "integer"
          },
          "memories": {
            "items": {
              "$ref": "#/components/schemas/DeveloperMemory"
            },
            "title": "Memories",
            "type": "array"
          }
        },
        "required": [
          "memories",
          "created_count"
        ],
        "title": "BatchMemoriesResponse",
        "type": "object"
      },
      "BatchMigrationRequest": {
        "properties": {
          "requests": {
            "items": {
              "$ref": "#/components/schemas/MigrationRequest"
            },
            "title": "Requests",
            "type": "array"
          }
        },
        "required": [
          "requests"
        ],
        "title": "BatchMigrationRequest",
        "type": "object"
      },
      "BatchMutationResponse": {
        "properties": {
          "locked_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Locked Ids"
          },
          "missing_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Missing Ids"
          },
          "noop_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Noop Ids"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "updated_count": {
            "title": "Updated Count",
            "type": "integer"
          },
          "updated_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated Ids"
          }
        },
        "required": [
          "status",
          "updated_count"
        ],
        "title": "BatchMutationResponse",
        "type": "object"
      },
      "BatchUpdateActionItemEntry": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "indent_level": {
            "anyOf": [
              {
                "maximum": 3,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Indent Level"
          },
          "sort_order": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sort Order"
          }
        },
        "required": [
          "id"
        ],
        "title": "BatchUpdateActionItemEntry",
        "type": "object"
      },
      "BatchUpdateActionItemsRequest": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/BatchUpdateActionItemEntry"
            },
            "maxItems": 500,
            "title": "Items",
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "title": "BatchUpdateActionItemsRequest",
        "type": "object"
      },
      "Body_create_app_v1_apps_post": {
        "properties": {
          "app_data": {
            "title": "App Data",
            "type": "string"
          },
          "file": {
            "format": "binary",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "app_data",
          "file"
        ],
        "title": "Body_create_app_v1_apps_post",
        "type": "object"
      },
      "Body_create_voice_message_stream_v2_voice_messages_post": {
        "properties": {
          "files": {
            "items": {
              "format": "binary",
              "type": "string"
            },
            "title": "Files",
            "type": "array"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          }
        },
        "required": [
          "files"
        ],
        "title": "Body_create_voice_message_stream_v2_voice_messages_post",
        "type": "object"
      },
      "Body_import_limitless_data_v1_import_limitless_post": {
        "properties": {
          "file": {
            "format": "binary",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_import_limitless_data_v1_import_limitless_post",
        "type": "object"
      },
      "Body_sync_local_files_v2_v2_sync_local_files_post": {
        "properties": {
          "files": {
            "items": {
              "format": "binary",
              "type": "string"
            },
            "title": "Files",
            "type": "array"
          }
        },
        "required": [
          "files"
        ],
        "title": "Body_sync_local_files_v2_v2_sync_local_files_post",
        "type": "object"
      },
      "Body_update_app_v1_apps__app_id__patch": {
        "properties": {
          "app_data": {
            "title": "App Data",
            "type": "string"
          },
          "file": {
            "format": "binary",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "app_data"
        ],
        "title": "Body_update_app_v1_apps__app_id__patch",
        "type": "object"
      },
      "Body_upload_app_thumbnail_endpoint_v1_app_thumbnails_post": {
        "properties": {
          "file": {
            "format": "binary",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_upload_app_thumbnail_endpoint_v1_app_thumbnails_post",
        "type": "object"
      },
      "Body_upload_file_chat_v2_files_post": {
        "properties": {
          "files": {
            "items": {
              "format": "binary",
              "type": "string"
            },
            "title": "Files",
            "type": "array"
          }
        },
        "required": [
          "files"
        ],
        "title": "Body_upload_file_chat_v2_files_post",
        "type": "object"
      },
      "Body_upload_profile_v3_upload_audio_post": {
        "properties": {
          "file": {
            "format": "binary",
            "title": "File",
            "type": "string"
          }
        },
        "required": [
          "file"
        ],
        "title": "Body_upload_profile_v3_upload_audio_post",
        "type": "object"
      },
      "BulkAssignSegmentsRequest": {
        "properties": {
          "assign_type": {
            "title": "Assign Type",
            "type": "string"
          },
          "segment_ids": {
            "items": {
              "type": "string"
            },
            "title": "Segment Ids",
            "type": "array"
          },
          "value": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Value"
          }
        },
        "required": [
          "segment_ids",
          "assign_type"
        ],
        "title": "BulkAssignSegmentsRequest",
        "type": "object"
      },
      "BulkMoveConversationsRequest": {
        "description": "Request model for moving multiple conversations to a folder.",
        "properties": {
          "conversation_ids": {
            "items": {
              "type": "string"
            },
            "title": "Conversation Ids",
            "type": "array"
          }
        },
        "required": [
          "conversation_ids"
        ],
        "title": "BulkMoveConversationsRequest",
        "type": "object"
      },
      "BulkMoveConversationsResponse": {
        "description": "Response for bulk folder conversation moves.",
        "properties": {
          "moved_count": {
            "default": 0,
            "title": "Moved Count",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "BulkMoveConversationsResponse",
        "type": "object"
      },
      "CalendarEventLink": {
        "description": "Links a conversation to a Google Calendar event.",
        "properties": {
          "attendee_emails": {
            "default": [],
            "description": "List of attendee email addresses",
            "items": {
              "type": "string"
            },
            "title": "Attendee Emails",
            "type": "array"
          },
          "attendees": {
            "default": [],
            "description": "List of attendee display names for UI",
            "items": {
              "type": "string"
            },
            "title": "Attendees",
            "type": "array"
          },
          "end_time": {
            "description": "Event end time",
            "format": "date-time",
            "title": "End Time",
            "type": "string"
          },
          "event_id": {
            "description": "Google Calendar event ID",
            "title": "Event Id",
            "type": "string"
          },
          "html_link": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Direct link to open event in Google Calendar",
            "title": "Html Link"
          },
          "start_time": {
            "description": "Event start time",
            "format": "date-time",
            "title": "Start Time",
            "type": "string"
          },
          "title": {
            "description": "Calendar event title",
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "event_id",
          "title",
          "start_time",
          "end_time"
        ],
        "title": "CalendarEventLink",
        "type": "object"
      },
      "CalendarMeetingContext": {
        "description": "Calendar meeting metadata to provide context for conversation processing",
        "properties": {
          "calendar_event_id": {
            "description": "System calendar event ID",
            "title": "Calendar Event Id",
            "type": "string"
          },
          "calendar_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "system_calendar",
            "description": "Calendar source (system_calendar, google, outlook, etc.)",
            "title": "Calendar Source"
          },
          "duration_minutes": {
            "description": "Meeting duration in minutes",
            "title": "Duration Minutes",
            "type": "integer"
          },
          "meeting_link": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "URL to join the meeting",
            "title": "Meeting Link"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Meeting notes/description from calendar",
            "title": "Notes"
          },
          "participants": {
            "description": "List of meeting participants",
            "items": {
              "$ref": "#/components/schemas/MeetingParticipant"
            },
            "title": "Participants",
            "type": "array"
          },
          "platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Meeting platform (Zoom, Teams, Google Meet, etc.)",
            "title": "Platform"
          },
          "start_time": {
            "description": "Meeting start time",
            "format": "date-time",
            "title": "Start Time",
            "type": "string"
          },
          "title": {
            "description": "Meeting title from calendar",
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "calendar_event_id",
          "title",
          "start_time",
          "duration_minutes"
        ],
        "title": "CalendarMeetingContext",
        "type": "object"
      },
      "CalendarOnboardingResetResponse": {
        "properties": {
          "reset": {
            "title": "Reset",
            "type": "boolean"
          }
        },
        "required": [
          "reset"
        ],
        "title": "CalendarOnboardingResetResponse",
        "type": "object"
      },
      "CalendarOnboardingSkipResponse": {
        "properties": {
          "skipped": {
            "title": "Skipped",
            "type": "boolean"
          }
        },
        "required": [
          "skipped"
        ],
        "title": "CalendarOnboardingSkipResponse",
        "type": "object"
      },
      "CalendarOnboardingStatusResponse": {
        "properties": {
          "connected": {
            "title": "Connected",
            "type": "boolean"
          },
          "needs_reconnect": {
            "title": "Needs Reconnect",
            "type": "boolean"
          },
          "onboarding_completed": {
            "title": "Onboarding Completed",
            "type": "boolean"
          },
          "reauth_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reauth Reason"
          },
          "state": {
            "title": "State",
            "type": "string"
          }
        },
        "required": [
          "connected",
          "onboarding_completed",
          "needs_reconnect",
          "state"
        ],
        "title": "CalendarOnboardingStatusResponse",
        "type": "object"
      },
      "CancelSubscriptionRequest": {
        "properties": {
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "reason_details": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason Details"
          }
        },
        "title": "CancelSubscriptionRequest",
        "type": "object"
      },
      "CandidateAction": {
        "enum": [
          "create",
          "update",
          "complete",
          "cancel",
          "supersede"
        ],
        "title": "CandidateAction",
        "type": "string"
      },
      "CandidateCreate": {
        "description": "Strict request union; each wire arm contains only fields valid for that action.",
        "discriminator": {
          "mapping": {
            "task": "#/components/schemas/TaskCandidate",
            "workstream": "#/components/schemas/WorkstreamCreateCandidate"
          },
          "propertyName": "subject_kind"
        },
        "oneOf": [
          {
            "$ref": "#/components/schemas/TaskCandidate"
          },
          {
            "$ref": "#/components/schemas/WorkstreamCreateCandidate"
          }
        ],
        "title": "CandidateCreate"
      },
      "CandidateListResponse": {
        "properties": {
          "candidates": {
            "items": {
              "$ref": "#/components/schemas/CandidateRecord"
            },
            "title": "Candidates",
            "type": "array"
          },
          "has_more": {
            "default": false,
            "title": "Has More",
            "type": "boolean"
          }
        },
        "required": [
          "candidates"
        ],
        "title": "CandidateListResponse",
        "type": "object"
      },
      "CandidateMigrationReport": {
        "additionalProperties": false,
        "properties": {
          "account_generation": {
            "minimum": 0,
            "title": "Account Generation",
            "type": "integer"
          },
          "checkpoint": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Checkpoint"
          },
          "created": {
            "minimum": 0,
            "title": "Created",
            "type": "integer"
          },
          "dry_run": {
            "title": "Dry Run",
            "type": "boolean"
          },
          "failed": {
            "minimum": 0,
            "title": "Failed",
            "type": "integer"
          },
          "failure_ids": {
            "items": {
              "maxLength": 128,
              "minLength": 1,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
              "type": "string"
            },
            "title": "Failure Ids",
            "type": "array"
          },
          "reconciled": {
            "minimum": 0,
            "title": "Reconciled",
            "type": "integer"
          },
          "scanned": {
            "minimum": 0,
            "title": "Scanned",
            "type": "integer"
          },
          "unchanged": {
            "minimum": 0,
            "title": "Unchanged",
            "type": "integer"
          },
          "workflow_mode": {
            "$ref": "#/components/schemas/TaskWorkflowMode"
          }
        },
        "required": [
          "workflow_mode",
          "account_generation",
          "dry_run",
          "scanned",
          "created",
          "reconciled",
          "unchanged",
          "failed",
          "failure_ids"
        ],
        "title": "CandidateMigrationReport",
        "type": "object"
      },
      "CandidateMigrationRequest": {
        "additionalProperties": false,
        "properties": {
          "after_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "After Id"
          },
          "limit": {
            "default": 500,
            "maximum": 500,
            "minimum": 1,
            "title": "Limit",
            "type": "integer"
          }
        },
        "title": "CandidateMigrationRequest",
        "type": "object"
      },
      "CandidateRecord": {
        "additionalProperties": false,
        "oneOf": [
          {
            "properties": {
              "proposed_action": {
                "const": "create"
              },
              "subject_kind": {
                "const": "task"
              },
              "task_change": {
                "$ref": "#/components/schemas/TaskCreatePayload"
              },
              "task_id": {
                "type": "null"
              },
              "workstream_proposal": {
                "type": "null"
              }
            },
            "required": [
              "task_change"
            ]
          },
          {
            "properties": {
              "proposed_action": {
                "const": "update"
              },
              "subject_kind": {
                "const": "task"
              },
              "task_change": {
                "$ref": "#/components/schemas/TaskChangePayload"
              },
              "task_id": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              "workstream_proposal": {
                "type": "null"
              }
            },
            "required": [
              "task_change",
              "task_id"
            ]
          },
          {
            "properties": {
              "proposed_action": {
                "const": "complete"
              },
              "subject_kind": {
                "const": "task"
              },
              "task_change": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskChangePayload"
                  },
                  {
                    "properties": {
                      "status": {
                        "const": "completed"
                      }
                    },
                    "required": [
                      "status"
                    ]
                  }
                ]
              },
              "task_id": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              "workstream_proposal": {
                "type": "null"
              }
            },
            "required": [
              "task_change",
              "task_id"
            ]
          },
          {
            "properties": {
              "proposed_action": {
                "const": "cancel"
              },
              "subject_kind": {
                "const": "task"
              },
              "task_change": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskChangePayload"
                  },
                  {
                    "properties": {
                      "status": {
                        "const": "cancelled"
                      }
                    },
                    "required": [
                      "status"
                    ]
                  }
                ]
              },
              "task_id": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              "workstream_proposal": {
                "type": "null"
              }
            },
            "required": [
              "task_change",
              "task_id"
            ]
          },
          {
            "properties": {
              "proposed_action": {
                "const": "supersede"
              },
              "subject_kind": {
                "const": "task"
              },
              "task_change": {
                "allOf": [
                  {
                    "$ref": "#/components/schemas/TaskChangePayload"
                  },
                  {
                    "properties": {
                      "status": {
                        "const": "superseded"
                      }
                    },
                    "required": [
                      "status",
                      "superseded_by"
                    ]
                  }
                ]
              },
              "task_id": {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              "workstream_proposal": {
                "type": "null"
              }
            },
            "required": [
              "task_change",
              "task_id"
            ]
          },
          {
            "properties": {
              "proposed_action": {
                "const": "create"
              },
              "subject_kind": {
                "const": "workstream"
              },
              "task_change": {
                "type": "null"
              },
              "task_id": {
                "type": "null"
              },
              "workstream_proposal": {
                "$ref": "#/components/schemas/WorkstreamProposal-Output"
              }
            },
            "required": [
              "workstream_proposal"
            ]
          }
        ],
        "properties": {
          "account_generation": {
            "minimum": 0,
            "title": "Account Generation",
            "type": "integer"
          },
          "candidate_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Candidate Id",
            "type": "string"
          },
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "idempotency_key": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Idempotency Key",
            "type": "string"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "$ref": "#/components/schemas/CandidateAction"
          },
          "resolution_reason": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolution Reason"
          },
          "resolved_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolved At"
          },
          "result_task_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result Task Id"
          },
          "result_workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result Workstream Id"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/CandidateStatus",
            "default": "pending"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/CandidateSubjectKind"
          },
          "task_change": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskCreatePayload"
              },
              {
                "$ref": "#/components/schemas/TaskChangePayload"
              },
              {
                "type": "null"
              }
            ],
            "title": "Task Change"
          },
          "task_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Task Id"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          },
          "workstream_proposal": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkstreamProposal-Output"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "subject_kind",
          "proposed_action",
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "candidate_id",
          "account_generation",
          "idempotency_key",
          "created_at"
        ],
        "title": "CandidateRecord",
        "type": "object"
      },
      "CandidateResolutionReceipt": {
        "additionalProperties": false,
        "properties": {
          "candidate_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Candidate Id",
            "type": "string"
          },
          "newly_resolved": {
            "title": "Newly Resolved",
            "type": "boolean"
          },
          "receipt_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Receipt Id",
            "type": "string"
          },
          "resolved_at": {
            "format": "date-time",
            "title": "Resolved At",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/CandidateStatus"
          },
          "task_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Task Id"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "candidate_id",
          "status",
          "receipt_id",
          "newly_resolved",
          "resolved_at"
        ],
        "title": "CandidateResolutionReceipt",
        "type": "object"
      },
      "CandidateResolutionRequest": {
        "additionalProperties": false,
        "properties": {
          "reason": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          }
        },
        "title": "CandidateResolutionRequest",
        "type": "object"
      },
      "CandidateStatus": {
        "enum": [
          "pending",
          "accepted",
          "rejected",
          "expired"
        ],
        "title": "CandidateStatus",
        "type": "string"
      },
      "CandidateSubjectKind": {
        "enum": [
          "task",
          "workstream"
        ],
        "title": "CandidateSubjectKind",
        "type": "string"
      },
      "CategoryEnum": {
        "enum": [
          "personal",
          "education",
          "health",
          "finance",
          "legal",
          "philosophy",
          "spiritual",
          "science",
          "entrepreneurship",
          "parenting",
          "romantic",
          "travel",
          "inspiration",
          "technology",
          "business",
          "social",
          "work",
          "sports",
          "politics",
          "literature",
          "history",
          "architecture",
          "music",
          "weather",
          "news",
          "entertainment",
          "psychology",
          "real",
          "design",
          "family",
          "economics",
          "environment",
          "other"
        ],
        "title": "CategoryEnum",
        "type": "string"
      },
      "ChartData": {
        "properties": {
          "chart_type": {
            "enum": [
              "line",
              "bar"
            ],
            "title": "Chart Type",
            "type": "string"
          },
          "datasets": {
            "items": {
              "$ref": "#/components/schemas/ChartDataset"
            },
            "title": "Datasets",
            "type": "array"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "x_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "X Label"
          },
          "y_label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Y Label"
          }
        },
        "required": [
          "chart_type",
          "title",
          "datasets"
        ],
        "title": "ChartData",
        "type": "object"
      },
      "ChartDataPoint": {
        "properties": {
          "label": {
            "title": "Label",
            "type": "string"
          },
          "value": {
            "title": "Value",
            "type": "number"
          }
        },
        "required": [
          "label",
          "value"
        ],
        "title": "ChartDataPoint",
        "type": "object"
      },
      "ChartDataset": {
        "properties": {
          "color": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Color"
          },
          "data_points": {
            "items": {
              "$ref": "#/components/schemas/ChartDataPoint"
            },
            "title": "Data Points",
            "type": "array"
          },
          "label": {
            "title": "Label",
            "type": "string"
          }
        },
        "required": [
          "label",
          "data_points"
        ],
        "title": "ChartDataset",
        "type": "object"
      },
      "ChatMessageCountResponse": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          }
        },
        "required": [
          "count"
        ],
        "title": "ChatMessageCountResponse",
        "type": "object"
      },
      "ChatQuotaUnit": {
        "enum": [
          "questions",
          "cost_usd"
        ],
        "title": "ChatQuotaUnit",
        "type": "string"
      },
      "ChatRatingResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "ChatRatingResponse",
        "type": "object"
      },
      "ChatTool": {
        "description": "Definition of a tool that an app provides for chat",
        "properties": {
          "auth_required": {
            "default": true,
            "title": "Auth Required",
            "type": "boolean"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "endpoint": {
            "title": "Endpoint",
            "type": "string"
          },
          "is_mcp": {
            "default": false,
            "title": "Is Mcp",
            "type": "boolean"
          },
          "method": {
            "default": "POST",
            "title": "Method",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "parameters": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parameters"
          },
          "status_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status Message"
          },
          "transport": {
            "default": "streamable_http",
            "title": "Transport",
            "type": "string"
          }
        },
        "required": [
          "name",
          "description",
          "endpoint"
        ],
        "title": "ChatTool",
        "type": "object"
      },
      "ChatUsageQuota": {
        "properties": {
          "allowed": {
            "default": true,
            "title": "Allowed",
            "type": "boolean"
          },
          "limit": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limit"
          },
          "percent": {
            "default": 0,
            "title": "Percent",
            "type": "number"
          },
          "plan": {
            "title": "Plan",
            "type": "string"
          },
          "plan_type": {
            "title": "Plan Type",
            "type": "string"
          },
          "reset_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reset At"
          },
          "unit": {
            "$ref": "#/components/schemas/ChatQuotaUnit"
          },
          "used": {
            "title": "Used",
            "type": "number"
          }
        },
        "required": [
          "plan",
          "plan_type",
          "unit",
          "used"
        ],
        "title": "ChatUsageQuota",
        "type": "object"
      },
      "CheckVerificationRequest": {
        "properties": {
          "phone_number": {
            "description": "Phone number in E.164 format",
            "title": "Phone Number",
            "type": "string"
          }
        },
        "required": [
          "phone_number"
        ],
        "title": "CheckVerificationRequest",
        "type": "object"
      },
      "CheckVerificationResponse": {
        "properties": {
          "phone_number_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Phone Number Id"
          },
          "verified": {
            "title": "Verified",
            "type": "boolean"
          }
        },
        "required": [
          "verified"
        ],
        "title": "CheckVerificationResponse",
        "type": "object"
      },
      "CleanerMemory": {
        "properties": {
          "archive_default_visible": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archive Default Visible"
          },
          "category": {
            "$ref": "#/components/schemas/MemoryCategory"
          },
          "category_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category Source"
          },
          "content": {
            "title": "Content",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "manually_added": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Manually Added"
          },
          "manually_added_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Manually Added Source"
          },
          "memory_default_memory": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Memory Default Memory"
          },
          "policy": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Policy"
          },
          "reviewed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reviewed"
          },
          "reviewed_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reviewed Source"
          }
        },
        "required": [
          "id",
          "content",
          "category"
        ],
        "title": "CleanerMemory",
        "type": "object"
      },
      "ClickUpListsResponse": {
        "properties": {
          "lists": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Lists",
            "type": "array"
          }
        },
        "title": "ClickUpListsResponse",
        "type": "object"
      },
      "ClickUpSpacesResponse": {
        "properties": {
          "spaces": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Spaces",
            "type": "array"
          }
        },
        "title": "ClickUpSpacesResponse",
        "type": "object"
      },
      "ClickUpTeamsResponse": {
        "properties": {
          "teams": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Teams",
            "type": "array"
          }
        },
        "title": "ClickUpTeamsResponse",
        "type": "object"
      },
      "ContextMatchSignal": {
        "enum": [
          "app",
          "person",
          "document",
          "meeting",
          "free_time",
          "dependency",
          "agent"
        ],
        "title": "ContextMatchSignal",
        "type": "string"
      },
      "ContinuationCheckpoint": {
        "additionalProperties": false,
        "properties": {
          "checkpoint_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Checkpoint Id",
            "type": "string"
          },
          "context_summary": {
            "maxLength": 4000,
            "title": "Context Summary",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "last_event_sequence": {
            "minimum": 0,
            "title": "Last Event Sequence",
            "type": "integer"
          },
          "runtime_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Runtime Id",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          },
          "workstream_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Workstream Id",
            "type": "string"
          }
        },
        "required": [
          "runtime_id",
          "last_event_sequence",
          "context_summary",
          "checkpoint_id",
          "workstream_id",
          "updated_at"
        ],
        "title": "ContinuationCheckpoint",
        "type": "object"
      },
      "ContinuationCheckpointUpsert": {
        "additionalProperties": false,
        "properties": {
          "context_summary": {
            "maxLength": 4000,
            "title": "Context Summary",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "last_event_sequence": {
            "minimum": 0,
            "title": "Last Event Sequence",
            "type": "integer"
          },
          "runtime_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Runtime Id",
            "type": "string"
          }
        },
        "required": [
          "runtime_id",
          "last_event_sequence",
          "context_summary"
        ],
        "title": "ContinuationCheckpointUpsert",
        "type": "object"
      },
      "Conversation": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "apps_results": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/AppResult"
            },
            "title": "Apps Results",
            "type": "array"
          },
          "audio_files": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/AudioFile"
            },
            "title": "Audio Files",
            "type": "array"
          },
          "calendar_event": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CalendarEventLink"
              },
              {
                "type": "null"
              }
            ]
          },
          "call_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Twilio call SID for phone call conversations",
            "title": "Call Id"
          },
          "client_device_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Device Id"
          },
          "client_platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Platform"
          },
          "conversation_audio": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationAudio"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "deferred": {
            "default": false,
            "title": "Deferred",
            "type": "boolean"
          },
          "discarded": {
            "default": false,
            "title": "Discarded",
            "type": "boolean"
          },
          "external_data": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "External Data"
          },
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "folder_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID of the folder this conversation belongs to",
            "title": "Folder Id"
          },
          "geolocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Geolocation"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "is_locked": {
            "default": false,
            "title": "Is Locked",
            "type": "boolean"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "photos": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/ConversationPhoto"
            },
            "title": "Photos",
            "type": "array"
          },
          "plugins_results": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/PluginResult"
            },
            "title": "Plugins Results",
            "type": "array"
          },
          "private_cloud_sync_enabled": {
            "default": false,
            "title": "Private Cloud Sync Enabled",
            "type": "boolean"
          },
          "processing_conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processing Conversation Id"
          },
          "processing_memory_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processing Memory Id"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationSource"
              },
              {
                "type": "null"
              }
            ],
            "default": "omi"
          },
          "starred": {
            "default": false,
            "title": "Starred",
            "type": "boolean"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationStatus"
              },
              {
                "type": "null"
              }
            ],
            "default": "completed"
          },
          "structured": {
            "$ref": "#/components/schemas/Structured"
          },
          "suggested_summarization_apps": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Suggested Summarization Apps",
            "type": "array"
          },
          "transcript_segments": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/TranscriptSegment"
            },
            "title": "Transcript Segments",
            "type": "array"
          },
          "transcript_segments_compressed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Transcript Segments Compressed"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "visibility": {
            "$ref": "#/components/schemas/ConversationVisibility",
            "default": "private"
          }
        },
        "required": [
          "id",
          "created_at",
          "started_at",
          "finished_at",
          "structured"
        ],
        "title": "Conversation",
        "type": "object"
      },
      "ConversationActionItemsCountResponse": {
        "properties": {
          "completed": {
            "title": "Completed",
            "type": "integer"
          },
          "incomplete": {
            "title": "Incomplete",
            "type": "integer"
          },
          "total": {
            "title": "Total",
            "type": "integer"
          }
        },
        "required": [
          "total",
          "completed",
          "incomplete"
        ],
        "title": "ConversationActionItemsCountResponse",
        "type": "object"
      },
      "ConversationActionItemsDeleteResponse": {
        "properties": {
          "deleted_count": {
            "title": "Deleted Count",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "deleted_count"
        ],
        "title": "ConversationActionItemsDeleteResponse",
        "type": "object"
      },
      "ConversationActionItemsResponse": {
        "properties": {
          "action_items": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Action Items",
            "type": "array"
          },
          "conversation_id": {
            "title": "Conversation Id",
            "type": "string"
          }
        },
        "required": [
          "action_items",
          "conversation_id"
        ],
        "title": "ConversationActionItemsResponse",
        "type": "object"
      },
      "ConversationAudio": {
        "description": "Stamp for the conversation-level playback artifact (playback/{uid}/{conv}/conversation.mp3).\n\naudio_files_fingerprint identifies the audio_files content the artifact was\nbuilt from; a mismatch with the doc's current audio_files means the artifact\nis stale and must be rebuilt.",
        "properties": {
          "audio_files_fingerprint": {
            "title": "Audio Files Fingerprint",
            "type": "string"
          },
          "built_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Built At"
          },
          "captured_duration": {
            "title": "Captured Duration",
            "type": "number"
          },
          "content_type": {
            "default": "audio/mpeg",
            "title": "Content Type",
            "type": "string"
          },
          "duration": {
            "title": "Duration",
            "type": "number"
          },
          "spans": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/ConversationAudioSpan"
            },
            "title": "Spans",
            "type": "array"
          }
        },
        "required": [
          "audio_files_fingerprint",
          "duration",
          "captured_duration"
        ],
        "title": "ConversationAudio",
        "type": "object"
      },
      "ConversationAudioSpan": {
        "description": "Maps one captured audio_file part into the dense conversation MP3.\n\nwall_offset is seconds relative to conversation.started_at (the same basis\nas TranscriptSegment.start); artifact_offset is seconds into the MP3. The\n>90s inter-part gaps are collapsed in the artifact, so segment-level seek is\nspan arithmetic: artifact_pos = artifact_offset + (segment.start - wall_offset).",
        "properties": {
          "artifact_offset": {
            "title": "Artifact Offset",
            "type": "number"
          },
          "file_id": {
            "title": "File Id",
            "type": "string"
          },
          "len": {
            "title": "Len",
            "type": "number"
          },
          "wall_offset": {
            "title": "Wall Offset",
            "type": "number"
          }
        },
        "required": [
          "file_id",
          "wall_offset",
          "artifact_offset",
          "len"
        ],
        "title": "ConversationAudioSpan",
        "type": "object"
      },
      "ConversationAudioSpanInfo": {
        "properties": {
          "artifact_offset": {
            "title": "Artifact Offset",
            "type": "number"
          },
          "file_id": {
            "title": "File Id",
            "type": "string"
          },
          "len": {
            "title": "Len",
            "type": "number"
          },
          "wall_offset": {
            "title": "Wall Offset",
            "type": "number"
          }
        },
        "required": [
          "file_id",
          "wall_offset",
          "artifact_offset",
          "len"
        ],
        "title": "ConversationAudioSpanInfo",
        "type": "object"
      },
      "ConversationAudioUrlInfo": {
        "properties": {
          "captured_duration": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Captured Duration"
          },
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "duration": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Duration"
          },
          "signed_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Signed Url"
          },
          "spans": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/ConversationAudioSpanInfo"
            },
            "title": "Spans",
            "type": "array"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "ConversationAudioUrlInfo",
        "type": "object"
      },
      "ConversationCreateResponse": {
        "properties": {
          "discarded": {
            "title": "Discarded",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "id",
          "status",
          "discarded"
        ],
        "title": "ConversationCreateResponse",
        "type": "object"
      },
      "ConversationFinalizationStatusResponse": {
        "description": "Customer-visible projection of one durable finalization job.",
        "properties": {
          "attempt_count": {
            "title": "Attempt Count",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "retryable": {
            "title": "Retryable",
            "type": "boolean"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "task_retry_count": {
            "title": "Task Retry Count",
            "type": "integer"
          },
          "terminal": {
            "title": "Terminal",
            "type": "boolean"
          }
        },
        "required": [
          "job_id",
          "status",
          "terminal",
          "retryable",
          "attempt_count",
          "task_retry_count"
        ],
        "title": "ConversationFinalizationStatusResponse",
        "type": "object"
      },
      "ConversationMutationResponse": {
        "description": "Canonical conversation snapshot returned after a user mutation.",
        "properties": {
          "conversation": {
            "$ref": "#/components/schemas/Conversation"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "conversation"
        ],
        "title": "ConversationMutationResponse",
        "type": "object"
      },
      "ConversationPhoto": {
        "properties": {
          "base64": {
            "title": "Base64",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "discarded": {
            "default": false,
            "title": "Discarded",
            "type": "boolean"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          }
        },
        "required": [
          "base64"
        ],
        "title": "ConversationPhoto",
        "type": "object"
      },
      "ConversationRecordingResponse": {
        "properties": {
          "has_recording": {
            "title": "Has Recording",
            "type": "boolean"
          }
        },
        "required": [
          "has_recording"
        ],
        "title": "ConversationRecordingResponse",
        "type": "object"
      },
      "ConversationSource": {
        "enum": [
          "friend",
          "omi",
          "fieldy",
          "bee",
          "plaud",
          "frame",
          "friend_com",
          "apple_watch",
          "phone",
          "phone_call",
          "desktop",
          "openglass",
          "screenpipe",
          "workflow",
          "sdcard",
          "external_integration",
          "limitless",
          "rayban_meta",
          "onboarding",
          "unknown"
        ],
        "title": "ConversationSource",
        "type": "string"
      },
      "ConversationStatus": {
        "enum": [
          "in_progress",
          "processing",
          "merging",
          "completed",
          "failed"
        ],
        "title": "ConversationStatus",
        "type": "string"
      },
      "ConversationStatusResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "ConversationStatusResponse",
        "type": "object"
      },
      "ConversationSuggestedAppsResponse": {
        "properties": {
          "conversation_id": {
            "title": "Conversation Id",
            "type": "string"
          },
          "suggested_apps": {
            "items": {
              "$ref": "#/components/schemas/App"
            },
            "title": "Suggested Apps",
            "type": "array"
          }
        },
        "required": [
          "suggested_apps",
          "conversation_id"
        ],
        "title": "ConversationSuggestedAppsResponse",
        "type": "object"
      },
      "ConversationTestPromptResponse": {
        "properties": {
          "summary": {
            "title": "Summary",
            "type": "string"
          }
        },
        "required": [
          "summary"
        ],
        "title": "ConversationTestPromptResponse",
        "type": "object"
      },
      "ConversationVisibility": {
        "enum": [
          "private",
          "shared",
          "public"
        ],
        "title": "ConversationVisibility",
        "type": "string"
      },
      "ConversationsCountResponse": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "sources": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sources"
          }
        },
        "required": [
          "count"
        ],
        "title": "ConversationsCountResponse",
        "type": "object"
      },
      "CreateActionItemRequest": {
        "properties": {
          "completed": {
            "default": false,
            "description": "Whether the action item is completed",
            "title": "Completed",
            "type": "boolean"
          },
          "description": {
            "description": "The action item description",
            "maxLength": 500,
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the action item is due (ISO format with timezone)",
            "title": "Due At"
          }
        },
        "required": [
          "description"
        ],
        "title": "CreateActionItemRequest",
        "type": "object"
      },
      "CreateAnnouncementRequest": {
        "description": "Request body for creating an announcement.",
        "properties": {
          "active": {
            "default": true,
            "title": "Active",
            "type": "boolean"
          },
          "app_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Version"
          },
          "content": {
            "additionalProperties": true,
            "title": "Content",
            "type": "object"
          },
          "device_models": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Models"
          },
          "display": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Display"
              },
              {
                "type": "null"
              }
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "firmware_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Firmware Version"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "targeting": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Targeting"
              },
              {
                "type": "null"
              }
            ]
          },
          "type": {
            "$ref": "#/components/schemas/AnnouncementType"
          }
        },
        "required": [
          "id",
          "type",
          "content"
        ],
        "title": "CreateAnnouncementRequest",
        "type": "object"
      },
      "CreateCheckoutRequest": {
        "properties": {
          "price_id": {
            "title": "Price Id",
            "type": "string"
          },
          "promotion_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Promotion Code"
          }
        },
        "required": [
          "price_id"
        ],
        "title": "CreateCheckoutRequest",
        "type": "object"
      },
      "CreateConversationFromTranscriptRequest": {
        "properties": {
          "client_device_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Capture device id ({platform}_{hash})",
            "title": "Client Device Id"
          },
          "client_platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Client platform (ios/android/macos)",
            "title": "Client Platform"
          },
          "client_session_id": {
            "anyOf": [
              {
                "maxLength": 200,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stable client-generated session ID. When provided, retries return the same conversation ID.",
            "title": "Client Session Id"
          },
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When conversation finished (calculated from segments duration if not provided)",
            "title": "Finished At"
          },
          "geolocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Geolocation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geolocation where conversation occurred"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "en",
            "description": "Language code (ISO 639-1, e.g., 'en', 'es', 'fr')",
            "title": "Language"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationSource"
              },
              {
                "type": "null"
              }
            ],
            "default": "phone",
            "description": "Source of the conversation (e.g., omi, friend, openglass, phone, external_integration)"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When conversation started (defaults to now)",
            "title": "Started At"
          },
          "transcript_segments": {
            "description": "List of transcript segments with speaker and timing info",
            "items": {
              "$ref": "#/components/schemas/CreateConversationTranscriptSegment"
            },
            "maxItems": 500,
            "minItems": 1,
            "title": "Transcript Segments",
            "type": "array"
          }
        },
        "required": [
          "transcript_segments"
        ],
        "title": "CreateConversationFromTranscriptRequest",
        "type": "object"
      },
      "CreateConversationRequest": {
        "properties": {
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the conversation finished (defaults to started_at + 5 minutes)",
            "title": "Finished At"
          },
          "geolocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Geolocation"
              },
              {
                "type": "null"
              }
            ],
            "description": "Geolocation where conversation occurred"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "en",
            "description": "Language code (ISO 639-1, e.g., 'en', 'es', 'fr')",
            "title": "Language"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "When the conversation started (defaults to now)",
            "title": "Started At"
          },
          "text": {
            "description": "The conversation text/transcript",
            "maxLength": 100000,
            "minLength": 1,
            "title": "Text",
            "type": "string"
          },
          "text_source": {
            "$ref": "#/components/schemas/ExternalIntegrationConversationSource",
            "default": "other_text",
            "description": "Source type: audio_transcript, message, or other_text"
          },
          "text_source_spec": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Additional source specification (e.g., 'email', 'slack', 'whatsapp')",
            "title": "Text Source Spec"
          }
        },
        "required": [
          "text"
        ],
        "title": "CreateConversationRequest",
        "type": "object"
      },
      "CreateConversationResponse": {
        "properties": {
          "conversation": {
            "$ref": "#/components/schemas/Conversation"
          },
          "messages": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/Message"
            },
            "title": "Messages",
            "type": "array"
          }
        },
        "required": [
          "conversation"
        ],
        "title": "CreateConversationResponse",
        "type": "object"
      },
      "CreateConversationTranscriptSegment": {
        "properties": {
          "end": {
            "description": "End time in seconds (e.g., 1.5, 3.0, 65.8)",
            "title": "End",
            "type": "number"
          },
          "is_user": {
            "default": false,
            "description": "Whether this segment is from the user",
            "title": "Is User",
            "type": "boolean"
          },
          "person_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID of person speaking (if known)",
            "title": "Person Id"
          },
          "speaker": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "SPEAKER_00",
            "description": "Speaker identifier (e.g., 'SPEAKER_00', 'SPEAKER_01')",
            "title": "Speaker"
          },
          "speaker_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "description": "Numeric speaker ID",
            "title": "Speaker Id"
          },
          "start": {
            "description": "Start time in seconds (e.g., 0.0, 1.5, 60.2)",
            "title": "Start",
            "type": "number"
          },
          "text": {
            "description": "The text spoken in this segment",
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "text",
          "start",
          "end"
        ],
        "title": "CreateConversationTranscriptSegment",
        "type": "object"
      },
      "CreateFolderRequest": {
        "description": "Request model for creating a new folder.",
        "properties": {
          "color": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Color"
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Natural language instruction for AI (e.g., 'Work meetings and project discussions')",
            "title": "Description"
          },
          "icon": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon"
          },
          "name": {
            "maxLength": 100,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "CreateFolderRequest",
        "type": "object"
      },
      "CreateGoalRequest": {
        "properties": {
          "current_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional current progress",
            "title": "Current Value"
          },
          "desired_outcome": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Desired Outcome"
          },
          "goal_type": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalType"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional metric type"
          },
          "horizon_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Horizon At"
          },
          "max_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional maximum scale value",
            "title": "Max Value"
          },
          "min_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional minimum scale value",
            "title": "Min Value"
          },
          "success_criteria": {
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "title": "Success Criteria",
            "type": "array"
          },
          "target_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional target value",
            "title": "Target Value"
          },
          "title": {
            "description": "The goal title/description",
            "maxLength": 500,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Unit label (e.g., 'users', 'points')",
            "title": "Unit"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          }
        },
        "required": [
          "title"
        ],
        "title": "CreateGoalRequest",
        "type": "object"
      },
      "CreateMemoryRequest": {
        "properties": {
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MemoryCategory"
              },
              {
                "type": "null"
              }
            ],
            "description": "Memory category: interesting, system, or manual (auto-categorized if not provided)"
          },
          "content": {
            "description": "The content of the memory",
            "maxLength": 500,
            "minLength": 1,
            "title": "Content",
            "type": "string"
          },
          "tags": {
            "default": [],
            "description": "Tags associated with the memory",
            "items": {
              "type": "string"
            },
            "title": "Tags",
            "type": "array"
          },
          "visibility": {
            "default": "private",
            "description": "Visibility: public or private",
            "title": "Visibility",
            "type": "string"
          }
        },
        "required": [
          "content"
        ],
        "title": "CreateMemoryRequest",
        "type": "object"
      },
      "CreatePerson": {
        "properties": {
          "name": {
            "maxLength": 40,
            "minLength": 2,
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "CreatePerson",
        "type": "object"
      },
      "CreateTaskRequest": {
        "description": "Request to create a task in an integration",
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Task description/notes",
            "title": "Description"
          },
          "due_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Due date in ISO format",
            "title": "Due Date"
          },
          "title": {
            "description": "Task title/name",
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title"
        ],
        "title": "CreateTaskRequest",
        "type": "object"
      },
      "CreateTaskResponse": {
        "description": "Response for task creation",
        "properties": {
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "external_task_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "External Task Id"
          },
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success"
        ],
        "title": "CreateTaskResponse",
        "type": "object"
      },
      "CustomerPortalSessionResponse": {
        "properties": {
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "CustomerPortalSessionResponse",
        "type": "object"
      },
      "DailySummariesResponse": {
        "properties": {
          "summaries": {
            "items": {
              "$ref": "#/components/schemas/DailySummaryResponse"
            },
            "title": "Summaries",
            "type": "array"
          }
        },
        "title": "DailySummariesResponse",
        "type": "object"
      },
      "DailySummaryActionItem": {
        "properties": {
          "completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "priority": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Priority"
          },
          "source_conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Conversation Id"
          }
        },
        "title": "DailySummaryActionItem",
        "type": "object"
      },
      "DailySummaryDayStats": {
        "properties": {
          "action_items_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Action Items Count"
          },
          "total_conversations": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Conversations"
          },
          "total_duration_minutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Duration Minutes"
          }
        },
        "title": "DailySummaryDayStats",
        "type": "object"
      },
      "DailySummaryDecisionMade": {
        "properties": {
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "decision": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Decision"
          }
        },
        "title": "DailySummaryDecisionMade",
        "type": "object"
      },
      "DailySummaryKnowledgeNugget": {
        "properties": {
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "insight": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Insight"
          }
        },
        "title": "DailySummaryKnowledgeNugget",
        "type": "object"
      },
      "DailySummaryLocationPin": {
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "latitude": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Latitude"
          },
          "longitude": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Longitude"
          },
          "time": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Time"
          }
        },
        "title": "DailySummaryLocationPin",
        "type": "object"
      },
      "DailySummaryResponse": {
        "additionalProperties": true,
        "properties": {
          "action_items": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DailySummaryActionItem"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Action Items"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Date"
          },
          "day_emoji": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Day Emoji"
          },
          "decisions_made": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DailySummaryDecisionMade"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Decisions Made"
          },
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Headline"
          },
          "highlights": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DailySummaryTopicHighlight"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Highlights"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "knowledge_nuggets": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DailySummaryKnowledgeNugget"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Knowledge Nuggets"
          },
          "locations": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DailySummaryLocationPin"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Locations"
          },
          "overview": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Overview"
          },
          "stats": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DailySummaryDayStats"
              },
              {
                "type": "null"
              }
            ]
          },
          "unresolved_questions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DailySummaryUnresolvedQuestion"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unresolved Questions"
          }
        },
        "title": "DailySummaryResponse",
        "type": "object"
      },
      "DailySummarySettingsResponse": {
        "properties": {
          "enabled": {
            "title": "Enabled",
            "type": "boolean"
          },
          "hour": {
            "title": "Hour",
            "type": "integer"
          }
        },
        "required": [
          "enabled",
          "hour"
        ],
        "title": "DailySummarySettingsResponse",
        "type": "object"
      },
      "DailySummarySettingsUpdate": {
        "properties": {
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "hour": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hour"
          }
        },
        "title": "DailySummarySettingsUpdate",
        "type": "object"
      },
      "DailySummaryTestResponse": {
        "properties": {
          "conversations_count": {
            "title": "Conversations Count",
            "type": "integer"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "summary_id": {
            "title": "Summary Id",
            "type": "string"
          }
        },
        "required": [
          "status",
          "summary_id",
          "conversations_count"
        ],
        "title": "DailySummaryTestResponse",
        "type": "object"
      },
      "DailySummaryTopicHighlight": {
        "properties": {
          "conversation_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Ids"
          },
          "emoji": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Emoji"
          },
          "summary": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Summary"
          },
          "topic": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Topic"
          }
        },
        "title": "DailySummaryTopicHighlight",
        "type": "object"
      },
      "DailySummaryUnresolvedQuestion": {
        "properties": {
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "question": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Question"
          }
        },
        "title": "DailySummaryUnresolvedQuestion",
        "type": "object"
      },
      "DecisionDebugProjection": {
        "additionalProperties": false,
        "properties": {
          "decisions": {
            "items": {
              "$ref": "#/components/schemas/DecisionRecord"
            },
            "title": "Decisions",
            "type": "array"
          },
          "projection": {
            "$ref": "#/components/schemas/WhatMattersNowProjection"
          }
        },
        "required": [
          "projection",
          "decisions"
        ],
        "title": "DecisionDebugProjection",
        "type": "object"
      },
      "DecisionRecord": {
        "additionalProperties": false,
        "description": "Debug-only audit record. It intentionally contains no prompt or model reasoning.",
        "properties": {
          "decision_summary": {
            "maxLength": 1024,
            "title": "Decision Summary",
            "type": "string"
          },
          "eligibility": {
            "$ref": "#/components/schemas/ShortlistEligibility"
          },
          "evaluated_at": {
            "format": "date-time",
            "title": "Evaluated At",
            "type": "string"
          },
          "evaluation_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Evaluation Id",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "fact_definition_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Fact Definition Version",
            "type": "string"
          },
          "facts_snapshot": {
            "$ref": "#/components/schemas/DeterministicFacts"
          },
          "final_output_ref": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Final Output Ref",
            "type": "string"
          },
          "model_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Model Version",
            "type": "string"
          },
          "policy_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Policy Version",
            "type": "string"
          },
          "prompt_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Prompt Version",
            "type": "string"
          },
          "reason_codes": {
            "items": {
              "type": "string"
            },
            "maxItems": 8,
            "title": "Reason Codes",
            "type": "array"
          },
          "shortlist_ids": {
            "items": {
              "maxLength": 128,
              "minLength": 1,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
              "type": "string"
            },
            "maxItems": 20,
            "title": "Shortlist Ids",
            "type": "array"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/RecommendationSubjectKind"
          }
        },
        "required": [
          "evaluation_id",
          "subject_kind",
          "subject_id",
          "shortlist_ids",
          "facts_snapshot",
          "eligibility",
          "prompt_version",
          "policy_version",
          "fact_definition_version",
          "model_version",
          "decision_summary",
          "reason_codes",
          "final_output_ref",
          "evaluated_at",
          "expires_at"
        ],
        "title": "DecisionRecord",
        "type": "object"
      },
      "DefaultTaskIntegrationRequest": {
        "description": "Request to set default task integration",
        "properties": {
          "app_key": {
            "description": "Task integration app key (e.g., 'asana', 'todoist')",
            "title": "App Key",
            "type": "string"
          }
        },
        "required": [
          "app_key"
        ],
        "title": "DefaultTaskIntegrationRequest",
        "type": "object"
      },
      "DefaultTaskIntegrationResponse": {
        "description": "Response for default task integration",
        "properties": {
          "default_app": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Default task integration app key",
            "title": "Default App"
          }
        },
        "required": [
          "default_app"
        ],
        "title": "DefaultTaskIntegrationResponse",
        "type": "object"
      },
      "DeleteAccountRequest": {
        "properties": {
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "reason_details": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason Details"
          }
        },
        "title": "DeleteAccountRequest",
        "type": "object"
      },
      "DeleteActionItemRequest": {
        "properties": {
          "completed": {
            "title": "Completed",
            "type": "boolean"
          },
          "description": {
            "title": "Description",
            "type": "string"
          }
        },
        "required": [
          "description",
          "completed"
        ],
        "title": "DeleteActionItemRequest",
        "type": "object"
      },
      "DeleteImportJobResponse": {
        "properties": {
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "job_id"
        ],
        "title": "DeleteImportJobResponse",
        "type": "object"
      },
      "DeleteKnowledgeGraphResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "DeleteKnowledgeGraphResponse",
        "type": "object"
      },
      "DeleteLimitlessConversationsResponse": {
        "properties": {
          "deleted_count": {
            "title": "Deleted Count",
            "type": "integer"
          },
          "message": {
            "title": "Message",
            "type": "string"
          }
        },
        "required": [
          "deleted_count",
          "message"
        ],
        "title": "DeleteLimitlessConversationsResponse",
        "type": "object"
      },
      "DeterministicFacts": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "context_match_signals": {
            "items": {
              "$ref": "#/components/schemas/ContextMatchSignal"
            },
            "maxItems": 4,
            "title": "Context Match Signals",
            "type": "array"
          },
          "days_to_due": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Days To Due"
          },
          "focused_goal_linked": {
            "default": false,
            "title": "Focused Goal Linked",
            "type": "boolean"
          },
          "has_concrete_next_action": {
            "title": "Has Concrete Next Action",
            "type": "boolean"
          },
          "someone_blocked": {
            "default": false,
            "title": "Someone Blocked",
            "type": "boolean"
          }
        },
        "required": [
          "has_concrete_next_action",
          "capture_confidence"
        ],
        "title": "DeterministicFacts",
        "type": "object"
      },
      "DevApiKey": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "key_prefix": {
            "title": "Key Prefix",
            "type": "string"
          },
          "last_used_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Used At"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "scopes": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scopes"
          }
        },
        "required": [
          "id",
          "name",
          "key_prefix",
          "created_at"
        ],
        "title": "DevApiKey",
        "type": "object"
      },
      "DevApiKeyCreate": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "scopes": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scopes"
          }
        },
        "required": [
          "name"
        ],
        "title": "DevApiKeyCreate",
        "type": "object"
      },
      "DevApiKeyCreated": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "key_prefix": {
            "title": "Key Prefix",
            "type": "string"
          },
          "last_used_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Used At"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "scopes": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scopes"
          }
        },
        "required": [
          "id",
          "name",
          "key_prefix",
          "created_at",
          "key"
        ],
        "title": "DevApiKeyCreated",
        "type": "object"
      },
      "DeveloperActionItem": {
        "properties": {
          "completed": {
            "title": "Completed",
            "type": "boolean"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "required": [
          "id",
          "description",
          "completed"
        ],
        "title": "DeveloperActionItem",
        "type": "object"
      },
      "DeveloperConversation": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "folder_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Folder Id"
          },
          "folder_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Folder Name"
          },
          "geolocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Geolocation"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "structured": {
            "$ref": "#/components/schemas/DeveloperConversationStructured"
          },
          "transcript_segments": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/DeveloperTranscriptSegment"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Transcript Segments"
          }
        },
        "required": [
          "id",
          "created_at",
          "started_at",
          "finished_at",
          "structured"
        ],
        "title": "DeveloperConversation",
        "type": "object"
      },
      "DeveloperConversationActionItem": {
        "properties": {
          "completed": {
            "default": false,
            "title": "Completed",
            "type": "boolean"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "required": [
          "description"
        ],
        "title": "DeveloperConversationActionItem",
        "type": "object"
      },
      "DeveloperConversationEvent": {
        "properties": {
          "created": {
            "default": false,
            "title": "Created",
            "type": "boolean"
          },
          "description": {
            "default": "",
            "title": "Description",
            "type": "string"
          },
          "duration": {
            "default": 30,
            "title": "Duration",
            "type": "integer"
          },
          "start": {
            "format": "date-time",
            "title": "Start",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "start"
        ],
        "title": "DeveloperConversationEvent",
        "type": "object"
      },
      "DeveloperConversationStructured": {
        "properties": {
          "action_items": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/DeveloperConversationActionItem"
            },
            "title": "Action Items",
            "type": "array"
          },
          "category": {
            "$ref": "#/components/schemas/CategoryEnum"
          },
          "emoji": {
            "default": "🧠",
            "title": "Emoji",
            "type": "string"
          },
          "events": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/DeveloperConversationEvent"
            },
            "title": "Events",
            "type": "array"
          },
          "overview": {
            "title": "Overview",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "overview",
          "category"
        ],
        "title": "DeveloperConversationStructured",
        "type": "object"
      },
      "DeveloperFolder": {
        "properties": {
          "color": {
            "title": "Color",
            "type": "string"
          },
          "conversation_count": {
            "default": 0,
            "title": "Conversation Count",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "icon": {
            "title": "Icon",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "is_default": {
            "default": false,
            "title": "Is Default",
            "type": "boolean"
          },
          "is_system": {
            "default": false,
            "title": "Is System",
            "type": "boolean"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "order": {
            "default": 0,
            "title": "Order",
            "type": "integer"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "color",
          "icon",
          "created_at",
          "updated_at"
        ],
        "title": "DeveloperFolder",
        "type": "object"
      },
      "DeveloperGoal": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "current_value": {
            "title": "Current Value",
            "type": "number"
          },
          "desired_outcome": {
            "title": "Desired Outcome",
            "type": "string"
          },
          "focus_rank": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Focus Rank"
          },
          "goal_id": {
            "title": "Goal Id",
            "type": "string"
          },
          "goal_type": {
            "title": "Goal Type",
            "type": "string"
          },
          "horizon_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Horizon At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "is_active": {
            "title": "Is Active",
            "type": "boolean"
          },
          "max_value": {
            "title": "Max Value",
            "type": "number"
          },
          "metric": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMetric"
              },
              {
                "type": "null"
              }
            ]
          },
          "min_value": {
            "title": "Min Value",
            "type": "number"
          },
          "source": {
            "title": "Source",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "success_criteria": {
            "items": {
              "type": "string"
            },
            "title": "Success Criteria",
            "type": "array"
          },
          "target_value": {
            "title": "Target Value",
            "type": "number"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unit"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          }
        },
        "required": [
          "id",
          "goal_id",
          "title",
          "desired_outcome",
          "status",
          "source",
          "goal_type",
          "target_value",
          "current_value",
          "min_value",
          "max_value",
          "is_active",
          "created_at",
          "updated_at"
        ],
        "title": "DeveloperGoal",
        "type": "object"
      },
      "DeveloperMemory": {
        "properties": {
          "category": {
            "$ref": "#/components/schemas/MemoryCategory",
            "default": "interesting"
          },
          "content": {
            "default": "",
            "title": "Content",
            "type": "string"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "edited": {
            "default": false,
            "title": "Edited",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "manually_added": {
            "default": false,
            "title": "Manually Added",
            "type": "boolean"
          },
          "reviewed": {
            "default": false,
            "title": "Reviewed",
            "type": "boolean"
          },
          "scoring": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scoring"
          },
          "tags": {
            "items": {
              "type": "string"
            },
            "title": "Tags",
            "type": "array"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "user_review": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Review"
          },
          "visibility": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "private",
            "title": "Visibility"
          }
        },
        "required": [
          "id"
        ],
        "title": "DeveloperMemory",
        "type": "object"
      },
      "DeveloperMemoryVectorItem": {
        "additionalProperties": true,
        "properties": {
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "content": {
            "default": "",
            "title": "Content",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "relevance_score": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Relevance Score"
          }
        },
        "required": [
          "id"
        ],
        "title": "DeveloperMemoryVectorItem",
        "type": "object"
      },
      "DeveloperMemoryVectorPolicy": {
        "properties": {
          "app_has_default_memory_grant": {
            "title": "App Has Default Memory Grant",
            "type": "boolean"
          },
          "archive_capability": {
            "title": "Archive Capability",
            "type": "boolean"
          },
          "consumer": {
            "title": "Consumer",
            "type": "string"
          },
          "raw_provenance_capability": {
            "title": "Raw Provenance Capability",
            "type": "boolean"
          }
        },
        "required": [
          "consumer",
          "app_has_default_memory_grant",
          "archive_capability",
          "raw_provenance_capability"
        ],
        "title": "DeveloperMemoryVectorPolicy",
        "type": "object"
      },
      "DeveloperMemoryVectorSearchResponse": {
        "properties": {
          "archive_default_visible": {
            "title": "Archive Default Visible",
            "type": "boolean"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/DeveloperMemoryVectorItem"
            },
            "title": "Items",
            "type": "array"
          },
          "policy": {
            "$ref": "#/components/schemas/DeveloperMemoryVectorPolicy"
          },
          "returned_count": {
            "title": "Returned Count",
            "type": "integer"
          }
        },
        "required": [
          "returned_count",
          "archive_default_visible",
          "policy"
        ],
        "title": "DeveloperMemoryVectorSearchResponse",
        "type": "object"
      },
      "DeveloperSuccessResponse": {
        "properties": {
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success"
        ],
        "title": "DeveloperSuccessResponse",
        "type": "object"
      },
      "DeveloperTranscriptSegment": {
        "properties": {
          "end": {
            "title": "End",
            "type": "number"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "speaker_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speaker Id"
          },
          "speaker_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speaker Name"
          },
          "start": {
            "title": "Start",
            "type": "number"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "text",
          "start",
          "end"
        ],
        "title": "DeveloperTranscriptSegment",
        "type": "object"
      },
      "DismissAnnouncementRequest": {
        "description": "Request body for dismissing an announcement.",
        "properties": {
          "cta_clicked": {
            "default": false,
            "title": "Cta Clicked",
            "type": "boolean"
          }
        },
        "title": "DismissAnnouncementRequest",
        "type": "object"
      },
      "DismissAnnouncementResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success",
          "message"
        ],
        "title": "DismissAnnouncementResponse",
        "type": "object"
      },
      "Display": {
        "description": "Controls how/when the announcement is displayed",
        "properties": {
          "dismissible": {
            "default": true,
            "title": "Dismissible",
            "type": "boolean"
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "priority": {
            "default": 0,
            "title": "Priority",
            "type": "integer"
          },
          "show_once": {
            "default": true,
            "title": "Show Once",
            "type": "boolean"
          },
          "start_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start At"
          }
        },
        "title": "Display",
        "type": "object"
      },
      "ErrorResponse": {
        "properties": {
          "detail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "array"
              },
              {
                "type": "object"
              }
            ],
            "description": "Error detail returned by the API."
          }
        },
        "required": [
          "detail"
        ],
        "title": "ErrorResponse",
        "type": "object"
      },
      "EvaluationRequest": {
        "additionalProperties": false,
        "properties": {
          "device_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Id"
          },
          "material_hint": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Material Hint"
          }
        },
        "title": "EvaluationRequest",
        "type": "object"
      },
      "Event": {
        "properties": {
          "created": {
            "default": false,
            "title": "Created",
            "type": "boolean"
          },
          "description": {
            "default": "",
            "description": "A brief description of the event",
            "title": "Description",
            "type": "string"
          },
          "duration": {
            "default": 30,
            "description": "The duration of the event in minutes",
            "title": "Duration",
            "type": "integer"
          },
          "start": {
            "description": "The start date and time of the event",
            "format": "date-time",
            "title": "Start",
            "type": "string"
          },
          "title": {
            "description": "The title of the event",
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "start"
        ],
        "title": "Event",
        "type": "object"
      },
      "Evidence": {
        "properties": {
          "artifact_ref": {
            "additionalProperties": true,
            "title": "Artifact Ref",
            "type": "object"
          },
          "capture_confidence": {
            "default": 0.5,
            "title": "Capture Confidence",
            "type": "number"
          },
          "client_device_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Device Id"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "evidence_id": {
            "title": "Evidence Id",
            "type": "string"
          },
          "extractor_id": {
            "default": "unknown",
            "title": "Extractor Id",
            "type": "string"
          },
          "extractor_version": {
            "default": "unknown",
            "title": "Extractor Version",
            "type": "string"
          },
          "independence_group": {
            "title": "Independence Group",
            "type": "string"
          },
          "redaction_status": {
            "default": "active",
            "title": "Redaction Status",
            "type": "string"
          },
          "source_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Source Id"
          },
          "source_signal": {
            "default": "unknown",
            "title": "Source Signal",
            "type": "string"
          },
          "source_type": {
            "default": "unknown",
            "title": "Source Type",
            "type": "string"
          }
        },
        "required": [
          "evidence_id",
          "independence_group"
        ],
        "title": "Evidence",
        "type": "object"
      },
      "EvidenceKind": {
        "enum": [
          "conversation",
          "memory_item",
          "workstream_event",
          "artifact",
          "chat_message",
          "local_screen",
          "external"
        ],
        "title": "EvidenceKind",
        "type": "string"
      },
      "EvidenceRef": {
        "additionalProperties": false,
        "properties": {
          "device_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Id"
          },
          "excerpt_hash": {
            "anyOf": [
              {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excerpt Hash"
          },
          "id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Id",
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/EvidenceKind"
          },
          "scope": {
            "$ref": "#/components/schemas/EvidenceScope"
          },
          "version": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          }
        },
        "required": [
          "kind",
          "id",
          "scope"
        ],
        "title": "EvidenceRef",
        "type": "object"
      },
      "EvidenceScope": {
        "enum": [
          "canonical",
          "device_local"
        ],
        "title": "EvidenceScope",
        "type": "string"
      },
      "ExecuteToolRequest": {
        "properties": {
          "params": {
            "additionalProperties": true,
            "default": {},
            "title": "Params",
            "type": "object"
          },
          "tool_name": {
            "title": "Tool Name",
            "type": "string"
          }
        },
        "required": [
          "tool_name"
        ],
        "title": "ExecuteToolRequest",
        "type": "object"
      },
      "ExecuteToolResponse": {
        "properties": {
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "result": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result"
          }
        },
        "title": "ExecuteToolResponse",
        "type": "object"
      },
      "ExternalIntegration": {
        "properties": {
          "actions": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/Action"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Actions"
          },
          "app_home_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Home Url"
          },
          "auth_steps": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/AuthStep"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Auth Steps"
          },
          "chat_messages_enabled": {
            "default": false,
            "title": "Chat Messages Enabled",
            "type": "boolean"
          },
          "chat_messages_notify": {
            "default": false,
            "title": "Chat Messages Notify",
            "type": "boolean"
          },
          "chat_messages_target": {
            "default": "app",
            "enum": [
              "main",
              "app"
            ],
            "title": "Chat Messages Target",
            "type": "string"
          },
          "chat_tools_manifest_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Tools Manifest Url"
          },
          "is_instructions_url": {
            "default": true,
            "title": "Is Instructions Url",
            "type": "boolean"
          },
          "mcp_oauth_tokens": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mcp Oauth Tokens"
          },
          "mcp_server_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mcp Server Url"
          },
          "setup_completed_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Setup Completed Url"
          },
          "setup_instructions_file_path": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Setup Instructions File Path"
          },
          "triggers_on": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Triggers On"
          },
          "webhook_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Webhook Url"
          }
        },
        "title": "ExternalIntegration",
        "type": "object"
      },
      "ExternalIntegrationConversationSource": {
        "enum": [
          "audio_transcript",
          "message",
          "other_text"
        ],
        "title": "ExternalIntegrationConversationSource",
        "type": "string"
      },
      "FairUseDailyGenerationsBudgetResponse": {
        "properties": {
          "daily_limit_ms": {
            "title": "Daily Limit Ms",
            "type": "integer"
          },
          "exhausted": {
            "title": "Exhausted",
            "type": "boolean"
          },
          "remaining_ms": {
            "title": "Remaining Ms",
            "type": "integer"
          },
          "resets_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resets At"
          },
          "used_ms": {
            "title": "Used Ms",
            "type": "integer"
          }
        },
        "required": [
          "daily_limit_ms",
          "used_ms",
          "remaining_ms",
          "exhausted"
        ],
        "title": "FairUseDailyGenerationsBudgetResponse",
        "type": "object"
      },
      "FairUseLimitsResponse": {
        "properties": {
          "daily_hours": {
            "title": "Daily Hours",
            "type": "number"
          },
          "three_day_hours": {
            "title": "Three Day Hours",
            "type": "number"
          },
          "weekly_hours": {
            "title": "Weekly Hours",
            "type": "number"
          }
        },
        "required": [
          "daily_hours",
          "three_day_hours",
          "weekly_hours"
        ],
        "title": "FairUseLimitsResponse",
        "type": "object"
      },
      "FairUseStatusResponse": {
        "properties": {
          "case_ref": {
            "title": "Case Ref",
            "type": "string"
          },
          "dg_budget": {
            "$ref": "#/components/schemas/FairUseDailyGenerationsBudgetResponse"
          },
          "limits": {
            "$ref": "#/components/schemas/FairUseLimitsResponse"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "speech_hours_3day": {
            "title": "Speech Hours 3Day",
            "type": "number"
          },
          "speech_hours_today": {
            "title": "Speech Hours Today",
            "type": "number"
          },
          "speech_hours_weekly": {
            "title": "Speech Hours Weekly",
            "type": "number"
          },
          "stage": {
            "title": "Stage",
            "type": "string"
          },
          "usage_pct": {
            "$ref": "#/components/schemas/FairUseUsagePctResponse"
          }
        },
        "required": [
          "stage",
          "case_ref",
          "speech_hours_today",
          "speech_hours_3day",
          "speech_hours_weekly",
          "limits",
          "usage_pct",
          "dg_budget",
          "message"
        ],
        "title": "FairUseStatusResponse",
        "type": "object"
      },
      "FairUseUsagePctResponse": {
        "properties": {
          "daily": {
            "title": "Daily",
            "type": "number"
          },
          "three_day": {
            "title": "Three Day",
            "type": "number"
          },
          "weekly": {
            "title": "Weekly",
            "type": "number"
          }
        },
        "required": [
          "daily",
          "three_day",
          "weekly"
        ],
        "title": "FairUseUsagePctResponse",
        "type": "object"
      },
      "FcmTokenResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "FcmTokenResponse",
        "type": "object"
      },
      "FeedbackCreate": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "$ref": "#/components/schemas/TaskIntelligenceFeedbackAction"
          },
          "context_snapshot_hash": {
            "anyOf": [
              {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Context Snapshot Hash"
          },
          "intervention_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Intervention Id"
          },
          "later_until": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Later Until"
          },
          "reason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskIntelligenceFeedbackReason"
              },
              {
                "type": "null"
              }
            ]
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          }
        },
        "required": [
          "subject_kind",
          "subject_id",
          "action"
        ],
        "title": "FeedbackCreate",
        "type": "object"
      },
      "FeedbackRecord": {
        "additionalProperties": false,
        "properties": {
          "action": {
            "$ref": "#/components/schemas/TaskIntelligenceFeedbackAction"
          },
          "attribution_chain_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Attribution Chain Id",
            "type": "string"
          },
          "context_snapshot_hash": {
            "anyOf": [
              {
                "pattern": "^[a-f0-9]{64}$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Context Snapshot Hash"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "dedupe_key": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dedupe Key"
          },
          "feedback_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Feedback Id",
            "type": "string"
          },
          "intervention_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Intervention Id"
          },
          "later_until": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Later Until"
          },
          "proposed_completion": {
            "default": false,
            "title": "Proposed Completion",
            "type": "boolean"
          },
          "proposed_completion_candidate_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Proposed Completion Candidate Id"
          },
          "reason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskIntelligenceFeedbackReason"
              },
              {
                "type": "null"
              }
            ]
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          }
        },
        "required": [
          "subject_kind",
          "subject_id",
          "action",
          "feedback_id",
          "attribution_chain_id",
          "created_at"
        ],
        "title": "FeedbackRecord",
        "type": "object"
      },
      "FeedbackSubjectKind": {
        "enum": [
          "candidate",
          "task",
          "workstream",
          "artifact",
          "decision"
        ],
        "title": "FeedbackSubjectKind",
        "type": "string"
      },
      "FileChat": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "mime_type": {
            "title": "Mime Type",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "openai_file_id": {
            "title": "Openai File Id",
            "type": "string"
          },
          "thumb_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "",
            "title": "Thumb Name"
          },
          "thumbnail": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "",
            "title": "Thumbnail"
          }
        },
        "required": [
          "id",
          "name",
          "mime_type",
          "openai_file_id",
          "created_at"
        ],
        "title": "FileChat",
        "type": "object"
      },
      "FirmwareVersionResponse": {
        "properties": {
          "changelog": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              }
            ],
            "default": "",
            "title": "Changelog"
          },
          "draft": {
            "default": false,
            "title": "Draft",
            "type": "boolean"
          },
          "is_legacy_secure_dfu": {
            "default": true,
            "title": "Is Legacy Secure Dfu",
            "type": "boolean"
          },
          "min_app_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min App Version"
          },
          "min_app_version_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min App Version Code"
          },
          "min_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Version"
          },
          "ota_update_steps": {
            "items": {
              "type": "string"
            },
            "title": "Ota Update Steps",
            "type": "array"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          },
          "zip_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Zip Url"
          }
        },
        "title": "FirmwareVersionResponse",
        "type": "object"
      },
      "FloatingBarSettings": {
        "properties": {
          "elevenlabs_voice_id": {
            "anyOf": [
              {
                "maxLength": 200,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Elevenlabs Voice Id"
          },
          "voice_answers_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Voice Answers Enabled"
          }
        },
        "title": "FloatingBarSettings",
        "type": "object"
      },
      "FocusAssistantSettings": {
        "properties": {
          "analysis_prompt": {
            "anyOf": [
              {
                "maxLength": 10000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysis Prompt"
          },
          "cooldown_interval": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cooldown Interval"
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "excluded_apps": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excluded Apps"
          },
          "notifications_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notifications Enabled"
          }
        },
        "title": "FocusAssistantSettings",
        "type": "object"
      },
      "Folder": {
        "description": "A folder for organizing conversations.",
        "properties": {
          "category_mapping": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Maps to CategoryEnum value for backwards compatibility",
            "title": "Category Mapping"
          },
          "color": {
            "default": "#6B7280",
            "title": "Color",
            "type": "string"
          },
          "conversation_count": {
            "default": 0,
            "title": "Conversation Count",
            "type": "integer"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Natural language instruction for AI folder assignment (e.g., 'Conversations about AI, machine learning, and building AI-powered apps')",
            "title": "Description"
          },
          "icon": {
            "default": "folder",
            "title": "Icon",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "is_default": {
            "default": false,
            "title": "Is Default",
            "type": "boolean"
          },
          "is_system": {
            "default": false,
            "description": "True for category-based default folders",
            "title": "Is System",
            "type": "boolean"
          },
          "name": {
            "maxLength": 100,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "order": {
            "default": 0,
            "title": "Order",
            "type": "integer"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name",
          "created_at",
          "updated_at"
        ],
        "title": "Folder",
        "type": "object"
      },
      "FolderMutationResponse": {
        "description": "Status response for folder mutation endpoints.",
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "FolderMutationResponse",
        "type": "object"
      },
      "FullConversation": {
        "properties": {
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "structured": {
            "$ref": "#/components/schemas/SimpleStructured"
          },
          "transcript_segments": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/SimpleTranscriptSegment"
            },
            "title": "Transcript Segments",
            "type": "array"
          }
        },
        "required": [
          "id",
          "started_at",
          "finished_at",
          "structured"
        ],
        "title": "FullConversation",
        "type": "object"
      },
      "GenerateAppIconRequest": {
        "properties": {
          "category": {
            "default": "other",
            "title": "Category",
            "type": "string"
          },
          "description": {
            "default": "",
            "title": "Description",
            "type": "string"
          },
          "name": {
            "default": "",
            "title": "Name",
            "type": "string"
          }
        },
        "title": "GenerateAppIconRequest",
        "type": "object"
      },
      "GenerateAppRequest": {
        "properties": {
          "prompt": {
            "default": "",
            "title": "Prompt",
            "type": "string"
          }
        },
        "title": "GenerateAppRequest",
        "type": "object"
      },
      "GenerateDescriptionEmojiRequest": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          },
          "prompt": {
            "title": "Prompt",
            "type": "string"
          }
        },
        "required": [
          "name",
          "prompt"
        ],
        "title": "GenerateDescriptionEmojiRequest",
        "type": "object"
      },
      "GenerateDescriptionRequest": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name",
          "description"
        ],
        "title": "GenerateDescriptionRequest",
        "type": "object"
      },
      "GenerateWrappedResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message"
        ],
        "title": "GenerateWrappedResponse",
        "type": "object"
      },
      "Geolocation": {
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          },
          "google_place_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Google Place Id"
          },
          "latitude": {
            "title": "Latitude",
            "type": "number"
          },
          "location_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location Type"
          },
          "longitude": {
            "title": "Longitude",
            "type": "number"
          }
        },
        "required": [
          "latitude",
          "longitude"
        ],
        "title": "Geolocation",
        "type": "object"
      },
      "GoalCreate": {
        "additionalProperties": false,
        "description": "Canonical create shape with explicit compatibility for released request fields.",
        "properties": {
          "current_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Value"
          },
          "desired_outcome": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Desired Outcome"
          },
          "goal_type": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalType"
              },
              {
                "type": "null"
              }
            ]
          },
          "horizon_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Horizon At"
          },
          "max_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Value"
          },
          "metric": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMetric"
              },
              {
                "type": "null"
              }
            ]
          },
          "min_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Value"
          },
          "source": {
            "$ref": "#/components/schemas/GoalSource",
            "default": "user"
          },
          "status": {
            "$ref": "#/components/schemas/GoalStatus",
            "default": "background"
          },
          "success_criteria": {
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "title": "Success Criteria",
            "type": "array"
          },
          "target_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Value"
          },
          "title": {
            "maxLength": 500,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unit"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          }
        },
        "required": [
          "title"
        ],
        "title": "GoalCreate",
        "type": "object"
      },
      "GoalDeleteResponse": {
        "properties": {
          "deleted_id": {
            "title": "Deleted Id",
            "type": "string"
          },
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success",
          "deleted_id"
        ],
        "title": "GoalDeleteResponse",
        "type": "object"
      },
      "GoalDetailProjection": {
        "additionalProperties": false,
        "properties": {
          "active_threads": {
            "items": {
              "$ref": "#/components/schemas/Workstream"
            },
            "title": "Active Threads",
            "type": "array"
          },
          "goal": {
            "$ref": "#/components/schemas/GoalResponse"
          },
          "progress_events": {
            "items": {
              "$ref": "#/components/schemas/GoalProgressEvent"
            },
            "title": "Progress Events",
            "type": "array"
          },
          "tasks": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Tasks",
            "type": "array"
          }
        },
        "required": [
          "goal",
          "active_threads",
          "tasks",
          "progress_events"
        ],
        "title": "GoalDetailProjection",
        "type": "object"
      },
      "GoalFocusRequest": {
        "additionalProperties": false,
        "properties": {
          "focus_rank": {
            "anyOf": [
              {
                "maximum": 4,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Focus Rank"
          },
          "replacement_goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Replacement Goal Id"
          }
        },
        "title": "GoalFocusRequest",
        "type": "object"
      },
      "GoalHistoryEntryResponse": {
        "properties": {
          "date": {
            "title": "Date",
            "type": "string"
          },
          "recorded_at": {
            "format": "date-time",
            "title": "Recorded At",
            "type": "string"
          },
          "value": {
            "title": "Value",
            "type": "number"
          }
        },
        "required": [
          "date",
          "value",
          "recorded_at"
        ],
        "title": "GoalHistoryEntryResponse",
        "type": "object"
      },
      "GoalLifecycleRequest": {
        "additionalProperties": false,
        "properties": {
          "relationship_disposition": {
            "$ref": "#/components/schemas/GoalRelationshipDisposition"
          },
          "status": {
            "$ref": "#/components/schemas/GoalStatus"
          }
        },
        "required": [
          "status",
          "relationship_disposition"
        ],
        "title": "GoalLifecycleRequest",
        "type": "object"
      },
      "GoalMetric": {
        "additionalProperties": false,
        "properties": {
          "current": {
            "title": "Current",
            "type": "number"
          },
          "max": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max"
          },
          "min": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min"
          },
          "target": {
            "title": "Target",
            "type": "number"
          },
          "type": {
            "$ref": "#/components/schemas/GoalType"
          },
          "unit": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unit"
          }
        },
        "required": [
          "type",
          "current",
          "target"
        ],
        "title": "GoalMetric",
        "type": "object"
      },
      "GoalOriginWorkIntent": {
        "additionalProperties": false,
        "properties": {
          "anchor_task_description": {
            "maxLength": 2000,
            "minLength": 1,
            "title": "Anchor Task Description",
            "type": "string"
          },
          "goal_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Goal Id",
            "type": "string"
          },
          "objective": {
            "maxLength": 2048,
            "minLength": 1,
            "title": "Objective",
            "type": "string"
          },
          "origin": {
            "const": "goal",
            "default": "goal",
            "title": "Origin",
            "type": "string"
          },
          "title": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "goal_id",
          "title",
          "objective",
          "anchor_task_description"
        ],
        "title": "GoalOriginWorkIntent",
        "type": "object"
      },
      "GoalProgressEvent": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "event_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Event Id",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Goal Id",
            "type": "string"
          },
          "kind": {
            "$ref": "#/components/schemas/GoalProgressEventKind"
          },
          "metric": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMetric"
              },
              {
                "type": "null"
              }
            ]
          },
          "sequence": {
            "minimum": 1,
            "title": "Sequence",
            "type": "integer"
          },
          "summary": {
            "maxLength": 1000,
            "minLength": 1,
            "title": "Summary",
            "type": "string"
          }
        },
        "required": [
          "event_id",
          "goal_id",
          "sequence",
          "kind",
          "summary",
          "created_at"
        ],
        "title": "GoalProgressEvent",
        "type": "object"
      },
      "GoalProgressEventCreate": {
        "additionalProperties": false,
        "properties": {
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "kind": {
            "$ref": "#/components/schemas/GoalProgressEventKind"
          },
          "metric": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMetric"
              },
              {
                "type": "null"
              }
            ]
          },
          "summary": {
            "maxLength": 1000,
            "minLength": 1,
            "title": "Summary",
            "type": "string"
          }
        },
        "required": [
          "kind",
          "summary"
        ],
        "title": "GoalProgressEventCreate",
        "type": "object"
      },
      "GoalProgressEventKind": {
        "enum": [
          "evidence",
          "metric_update",
          "milestone",
          "status_change"
        ],
        "title": "GoalProgressEventKind",
        "type": "string"
      },
      "GoalRelationshipDisposition": {
        "enum": [
          "retain",
          "detach"
        ],
        "title": "GoalRelationshipDisposition",
        "type": "string"
      },
      "GoalResponse": {
        "description": "Canonical response plus non-null aliases required by released clients.",
        "properties": {
          "advice": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Advice"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "current_value": {
            "title": "Current Value",
            "type": "number"
          },
          "desired_outcome": {
            "title": "Desired Outcome",
            "type": "string"
          },
          "ended_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ended At"
          },
          "focus_rank": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Focus Rank"
          },
          "goal_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Goal Id",
            "type": "string"
          },
          "goal_type": {
            "title": "Goal Type",
            "type": "string"
          },
          "horizon_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Horizon At"
          },
          "id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Id",
            "type": "string"
          },
          "is_active": {
            "title": "Is Active",
            "type": "boolean"
          },
          "latest_progress_sequence": {
            "default": 0,
            "title": "Latest Progress Sequence",
            "type": "integer"
          },
          "max_value": {
            "title": "Max Value",
            "type": "number"
          },
          "metric": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMetric"
              },
              {
                "type": "null"
              }
            ]
          },
          "min_value": {
            "title": "Min Value",
            "type": "number"
          },
          "source": {
            "$ref": "#/components/schemas/GoalSource"
          },
          "status": {
            "$ref": "#/components/schemas/GoalStatus"
          },
          "success_criteria": {
            "items": {
              "type": "string"
            },
            "title": "Success Criteria",
            "type": "array"
          },
          "target_value": {
            "title": "Target Value",
            "type": "number"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unit"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          }
        },
        "required": [
          "id",
          "goal_id",
          "title",
          "desired_outcome",
          "status",
          "source",
          "created_at",
          "updated_at",
          "goal_type",
          "target_value",
          "current_value",
          "min_value",
          "max_value",
          "is_active"
        ],
        "title": "GoalResponse",
        "type": "object"
      },
      "GoalSource": {
        "enum": [
          "user",
          "ai_suggested",
          "imported"
        ],
        "title": "GoalSource",
        "type": "string"
      },
      "GoalStatus": {
        "enum": [
          "background",
          "focused",
          "paused",
          "achieved",
          "abandoned"
        ],
        "title": "GoalStatus",
        "type": "string"
      },
      "GoalSuggestionResponse": {
        "properties": {
          "reasoning": {
            "title": "Reasoning",
            "type": "string"
          },
          "suggested_max": {
            "default": 10,
            "title": "Suggested Max",
            "type": "number"
          },
          "suggested_min": {
            "default": 0,
            "title": "Suggested Min",
            "type": "number"
          },
          "suggested_target": {
            "title": "Suggested Target",
            "type": "number"
          },
          "suggested_title": {
            "title": "Suggested Title",
            "type": "string"
          },
          "suggested_type": {
            "title": "Suggested Type",
            "type": "string"
          }
        },
        "required": [
          "suggested_title",
          "suggested_type",
          "suggested_target",
          "reasoning"
        ],
        "title": "GoalSuggestionResponse",
        "type": "object"
      },
      "GoalType": {
        "enum": [
          "boolean",
          "scale",
          "numeric"
        ],
        "title": "GoalType",
        "type": "string"
      },
      "GoalUpdate": {
        "additionalProperties": false,
        "properties": {
          "clear_metric": {
            "default": false,
            "title": "Clear Metric",
            "type": "boolean"
          },
          "current_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Value"
          },
          "desired_outcome": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Desired Outcome"
          },
          "horizon_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Horizon At"
          },
          "max_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Value"
          },
          "metric": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GoalMetric"
              },
              {
                "type": "null"
              }
            ]
          },
          "min_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Value"
          },
          "success_criteria": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Success Criteria"
          },
          "target_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Target Value"
          },
          "title": {
            "anyOf": [
              {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "unit": {
            "anyOf": [
              {
                "maxLength": 64,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Unit"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          }
        },
        "title": "GoalUpdate",
        "type": "object"
      },
      "GoogleCalendarEvent": {
        "description": "Response model for a Google Calendar event.",
        "properties": {
          "attendee_emails": {
            "default": [],
            "description": "List of attendee email addresses",
            "items": {
              "type": "string"
            },
            "title": "Attendee Emails",
            "type": "array"
          },
          "attendees": {
            "default": [],
            "description": "List of attendee display names",
            "items": {
              "type": "string"
            },
            "title": "Attendees",
            "type": "array"
          },
          "end_time": {
            "description": "Event end time",
            "format": "date-time",
            "title": "End Time",
            "type": "string"
          },
          "event_id": {
            "description": "Google Calendar event ID",
            "title": "Event Id",
            "type": "string"
          },
          "html_link": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Link to open event in Google Calendar",
            "title": "Html Link"
          },
          "start_time": {
            "description": "Event start time",
            "format": "date-time",
            "title": "Start Time",
            "type": "string"
          },
          "title": {
            "description": "Event title/summary",
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "event_id",
          "title",
          "start_time",
          "end_time"
        ],
        "title": "GoogleCalendarEvent",
        "type": "object"
      },
      "HTTPValidationError": {
        "properties": {
          "detail": {
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "title": "Detail",
            "type": "array"
          }
        },
        "title": "HTTPValidationError",
        "type": "object"
      },
      "HasSpeechProfileResponse": {
        "properties": {
          "has_profile": {
            "title": "Has Profile",
            "type": "boolean"
          }
        },
        "required": [
          "has_profile"
        ],
        "title": "HasSpeechProfileResponse",
        "type": "object"
      },
      "ImportJobResponse": {
        "properties": {
          "conversations_created": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversations Created"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "processed_files": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processed Files"
          },
          "status": {
            "$ref": "#/components/schemas/ImportJobStatus"
          },
          "total_files": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Files"
          }
        },
        "required": [
          "job_id",
          "status"
        ],
        "title": "ImportJobResponse",
        "type": "object"
      },
      "ImportJobStatus": {
        "enum": [
          "pending",
          "processing",
          "completed",
          "failed",
          "cancelled"
        ],
        "title": "ImportJobStatus",
        "type": "string"
      },
      "IntegrationData": {
        "description": "Data for an integration connection",
        "properties": {
          "access_token": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Access Token"
          },
          "connected": {
            "default": true,
            "title": "Connected",
            "type": "boolean"
          },
          "refresh_token": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Refresh Token"
          }
        },
        "title": "IntegrationData",
        "type": "object"
      },
      "IntegrationMutationResponse": {
        "properties": {
          "app_key": {
            "title": "App Key",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "app_key"
        ],
        "title": "IntegrationMutationResponse",
        "type": "object"
      },
      "IntegrationNotificationResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "IntegrationNotificationResponse",
        "type": "object"
      },
      "IntegrationResponse": {
        "description": "Response containing integration status",
        "properties": {
          "app_key": {
            "description": "Integration app key",
            "title": "App Key",
            "type": "string"
          },
          "connected": {
            "description": "Whether the integration is connected",
            "title": "Connected",
            "type": "boolean"
          }
        },
        "required": [
          "connected",
          "app_key"
        ],
        "title": "IntegrationResponse",
        "type": "object"
      },
      "InterventionCreate": {
        "additionalProperties": false,
        "properties": {
          "dedupe_key": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Dedupe Key",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          },
          "surface": {
            "$ref": "#/components/schemas/InterventionSurface"
          }
        },
        "required": [
          "surface",
          "subject_kind",
          "subject_id",
          "dedupe_key",
          "expires_at"
        ],
        "title": "InterventionCreate",
        "type": "object"
      },
      "InterventionRecord": {
        "additionalProperties": false,
        "properties": {
          "attribution_chain_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Attribution Chain Id",
            "type": "string"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "dedupe_key": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Dedupe Key",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "intervention_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Intervention Id",
            "type": "string"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          },
          "surface": {
            "$ref": "#/components/schemas/InterventionSurface"
          }
        },
        "required": [
          "surface",
          "subject_kind",
          "subject_id",
          "dedupe_key",
          "expires_at",
          "intervention_id",
          "attribution_chain_id",
          "created_at"
        ],
        "title": "InterventionRecord",
        "type": "object"
      },
      "InterventionSurface": {
        "enum": [
          "suggested",
          "what_matters_now"
        ],
        "title": "InterventionSurface",
        "type": "string"
      },
      "KnowledgeGraphResponse": {
        "properties": {
          "edges": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Edges",
            "type": "array"
          },
          "nodes": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Nodes",
            "type": "array"
          }
        },
        "required": [
          "nodes",
          "edges"
        ],
        "title": "KnowledgeGraphResponse",
        "type": "object"
      },
      "LinkCalendarEventRequest": {
        "properties": {
          "event_id": {
            "title": "Event Id",
            "type": "string"
          }
        },
        "required": [
          "event_id"
        ],
        "title": "LinkCalendarEventRequest",
        "type": "object"
      },
      "LlmTotalCostResponse": {
        "properties": {
          "total_cost_usd": {
            "title": "Total Cost Usd",
            "type": "number"
          }
        },
        "required": [
          "total_cost_usd"
        ],
        "title": "LlmTotalCostResponse",
        "type": "object"
      },
      "LlmUsageFeatureResponse": {
        "properties": {
          "call_count": {
            "default": 0,
            "title": "Call Count",
            "type": "integer"
          },
          "feature": {
            "title": "Feature",
            "type": "string"
          },
          "input_tokens": {
            "default": 0,
            "title": "Input Tokens",
            "type": "integer"
          },
          "output_tokens": {
            "default": 0,
            "title": "Output Tokens",
            "type": "integer"
          },
          "total_tokens": {
            "default": 0,
            "title": "Total Tokens",
            "type": "integer"
          }
        },
        "required": [
          "feature"
        ],
        "title": "LlmUsageFeatureResponse",
        "type": "object"
      },
      "LlmUsageRecordResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "LlmUsageRecordResponse",
        "type": "object"
      },
      "LlmUsageResponse": {
        "properties": {
          "period_days": {
            "title": "Period Days",
            "type": "integer"
          },
          "summary": {
            "additionalProperties": true,
            "title": "Summary",
            "type": "object"
          },
          "top_features": {
            "items": {
              "$ref": "#/components/schemas/LlmUsageFeatureResponse"
            },
            "title": "Top Features",
            "type": "array"
          }
        },
        "required": [
          "period_days"
        ],
        "title": "LlmUsageResponse",
        "type": "object"
      },
      "McpAddServerResponse": {
        "properties": {
          "app_id": {
            "title": "App Id",
            "type": "string"
          },
          "auth_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Auth Url"
          },
          "requires_oauth": {
            "title": "Requires Oauth",
            "type": "boolean"
          },
          "tool_names": {
            "items": {
              "type": "string"
            },
            "title": "Tool Names",
            "type": "array"
          },
          "tools_count": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tools Count"
          }
        },
        "required": [
          "app_id",
          "requires_oauth"
        ],
        "title": "McpAddServerResponse",
        "type": "object"
      },
      "McpApiKey": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "key_prefix": {
            "title": "Key Prefix",
            "type": "string"
          },
          "last_used_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Used At"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "scopes": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scopes"
          }
        },
        "required": [
          "id",
          "name",
          "key_prefix",
          "created_at"
        ],
        "title": "McpApiKey",
        "type": "object"
      },
      "McpApiKeyCreate": {
        "properties": {
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name"
        ],
        "title": "McpApiKeyCreate",
        "type": "object"
      },
      "McpApiKeyCreated": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "key": {
            "title": "Key",
            "type": "string"
          },
          "key_prefix": {
            "title": "Key Prefix",
            "type": "string"
          },
          "last_used_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Used At"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "scopes": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scopes"
          }
        },
        "required": [
          "id",
          "name",
          "key_prefix",
          "created_at",
          "key"
        ],
        "title": "McpApiKeyCreated",
        "type": "object"
      },
      "McpCreateActionItem": {
        "properties": {
          "completed": {
            "default": false,
            "title": "Completed",
            "type": "boolean"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          }
        },
        "required": [
          "description"
        ],
        "title": "McpCreateActionItem",
        "type": "object"
      },
      "McpOauthGrantsResponse": {
        "properties": {
          "grants": {
            "default": [],
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Grants",
            "type": "array"
          }
        },
        "title": "McpOauthGrantsResponse",
        "type": "object"
      },
      "McpRefreshToolsResponse": {
        "properties": {
          "tool_names": {
            "items": {
              "type": "string"
            },
            "title": "Tool Names",
            "type": "array"
          },
          "tools_count": {
            "title": "Tools Count",
            "type": "integer"
          }
        },
        "required": [
          "tools_count"
        ],
        "title": "McpRefreshToolsResponse",
        "type": "object"
      },
      "McpScreenActivityAppSummary": {
        "properties": {
          "count": {
            "default": 0,
            "title": "Count",
            "type": "integer"
          },
          "first_seen": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "First Seen"
          },
          "last_seen": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Seen"
          },
          "window_titles": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Window Titles",
            "type": "array"
          }
        },
        "title": "McpScreenActivityAppSummary",
        "type": "object"
      },
      "McpScreenActivityRow": {
        "properties": {
          "app_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Name"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "ocr_text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ocr Text"
          },
          "timestamp": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Timestamp"
          },
          "window_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Window Title"
          }
        },
        "title": "McpScreenActivityRow",
        "type": "object"
      },
      "McpScreenActivitySummaryResponse": {
        "properties": {
          "apps": {
            "additionalProperties": {
              "$ref": "#/components/schemas/McpScreenActivityAppSummary"
            },
            "default": {},
            "title": "Apps",
            "type": "object"
          },
          "total_screenshots": {
            "default": 0,
            "title": "Total Screenshots",
            "type": "integer"
          }
        },
        "title": "McpScreenActivitySummaryResponse",
        "type": "object"
      },
      "McpServerRequest": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "mcp_server_url": {
            "title": "Mcp Server Url",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "name",
          "mcp_server_url"
        ],
        "title": "McpServerRequest",
        "type": "object"
      },
      "McpSseAuthMethodResponse": {
        "properties": {
          "authorization_endpoint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Authorization Endpoint"
          },
          "format": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Format"
          },
          "header": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Header"
          },
          "resource": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resource"
          },
          "scopes": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Scopes",
            "type": "array"
          },
          "token_endpoint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Token Endpoint"
          }
        },
        "title": "McpSseAuthMethodResponse",
        "type": "object"
      },
      "McpSseAuthenticationResponse": {
        "properties": {
          "api_key": {
            "$ref": "#/components/schemas/McpSseAuthMethodResponse"
          },
          "methods": {
            "items": {
              "type": "string"
            },
            "title": "Methods",
            "type": "array"
          },
          "oauth2": {
            "$ref": "#/components/schemas/McpSseAuthMethodResponse"
          }
        },
        "required": [
          "methods",
          "api_key",
          "oauth2"
        ],
        "title": "McpSseAuthenticationResponse",
        "type": "object"
      },
      "McpSseInfoResponse": {
        "properties": {
          "authentication": {
            "$ref": "#/components/schemas/McpSseAuthenticationResponse"
          },
          "endpoint": {
            "title": "Endpoint",
            "type": "string"
          },
          "instructions": {
            "$ref": "#/components/schemas/McpSseInstructionsResponse"
          },
          "protocol_version": {
            "title": "Protocol Version",
            "type": "string"
          },
          "transport": {
            "title": "Transport",
            "type": "string"
          }
        },
        "required": [
          "endpoint",
          "transport",
          "protocol_version",
          "authentication",
          "instructions"
        ],
        "title": "McpSseInfoResponse",
        "type": "object"
      },
      "McpSseInstructionsResponse": {
        "properties": {
          "step1": {
            "title": "Step1",
            "type": "string"
          },
          "step2": {
            "title": "Step2",
            "type": "string"
          },
          "step3": {
            "title": "Step3",
            "type": "string"
          }
        },
        "required": [
          "step1",
          "step2",
          "step3"
        ],
        "title": "McpSseInstructionsResponse",
        "type": "object"
      },
      "McpStatusResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "McpStatusResponse",
        "type": "object"
      },
      "McpUpdateActionItem": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          }
        },
        "title": "McpUpdateActionItem",
        "type": "object"
      },
      "MeetingParticipant": {
        "description": "Represents a participant in a calendar meeting",
        "properties": {
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Participant's email address",
            "title": "Email"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Participant's display name",
            "title": "Name"
          }
        },
        "title": "MeetingParticipant",
        "type": "object"
      },
      "Memory": {
        "properties": {
          "arguments": {
            "additionalProperties": true,
            "description": "Canonical proposition arguments keyed by semantic slot",
            "title": "Arguments",
            "type": "object"
          },
          "capture_confidence": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixed confidence that the source was captured correctly",
            "title": "Capture Confidence"
          },
          "category": {
            "$ref": "#/components/schemas/MemoryCategory",
            "default": "interesting",
            "description": "The category of the memory"
          },
          "content": {
            "description": "The content of the memory",
            "title": "Content",
            "type": "string"
          },
          "durability": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Expected durability horizon for the fact",
            "title": "Durability"
          },
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Short headline for notification preview (max 5 words)",
            "title": "Headline"
          },
          "object_entity_ids": {
            "description": "Stable entity ids referenced by the fact arguments",
            "items": {
              "type": "string"
            },
            "title": "Object Entity Ids",
            "type": "array"
          },
          "predicate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Canonical relation for the fact, e.g. resides_in, works_at, prefers",
            "title": "Predicate"
          },
          "qualifiers": {
            "additionalProperties": true,
            "description": "Optional proposition qualifiers such as scope, valid_time, or epistemic_status",
            "title": "Qualifiers",
            "type": "object"
          },
          "subject_attribution": {
            "$ref": "#/components/schemas/SubjectAttribution",
            "default": "unknown",
            "description": "How the memory subject was attributed"
          },
          "subject_entity_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stable entity id for who/what the fact is about",
            "title": "Subject Entity Id"
          },
          "tags": {
            "description": "The tags of the memory and learning",
            "items": {
              "type": "string"
            },
            "title": "Tags",
            "type": "array"
          },
          "uncertainty_reasons": {
            "description": "Reasons this fact needs caution or review",
            "items": {
              "type": "string"
            },
            "title": "Uncertainty Reasons",
            "type": "array"
          },
          "veracity": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current belief that the fact is true",
            "title": "Veracity"
          },
          "visibility": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "private",
            "description": "The visibility of the memory",
            "title": "Visibility"
          }
        },
        "required": [
          "content"
        ],
        "title": "Memory",
        "type": "object"
      },
      "MemoryAssistantSettings": {
        "properties": {
          "analysis_prompt": {
            "anyOf": [
              {
                "maxLength": 10000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysis Prompt"
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "excluded_apps": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Excluded Apps"
          },
          "extraction_interval": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Extraction Interval"
          },
          "min_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Confidence"
          },
          "notifications_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notifications Enabled"
          }
        },
        "title": "MemoryAssistantSettings",
        "type": "object"
      },
      "MemoryCategory": {
        "enum": [
          "interesting",
          "system",
          "manual",
          "workflow",
          "core",
          "hobbies",
          "lifestyle",
          "interests",
          "habits",
          "work",
          "skills",
          "learnings",
          "other",
          "auto"
        ],
        "title": "MemoryCategory",
        "type": "string"
      },
      "MemoryDB": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "arguments": {
            "additionalProperties": true,
            "description": "Canonical proposition arguments keyed by semantic slot",
            "title": "Arguments",
            "type": "object"
          },
          "capture_confidence": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fixed confidence that the source was captured correctly",
            "title": "Capture Confidence"
          },
          "capture_device_ids": {
            "items": {
              "type": "string"
            },
            "title": "Capture Device Ids",
            "type": "array"
          },
          "category": {
            "$ref": "#/components/schemas/MemoryCategory",
            "default": "interesting",
            "description": "The category of the memory"
          },
          "content": {
            "description": "The content of the memory",
            "title": "Content",
            "type": "string"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "durability": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Expected durability horizon for the fact",
            "title": "Durability"
          },
          "edited": {
            "default": false,
            "title": "Edited",
            "type": "boolean"
          },
          "evidence": {
            "items": {
              "$ref": "#/components/schemas/Evidence"
            },
            "title": "Evidence",
            "type": "array"
          },
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Short headline for notification preview (max 5 words)",
            "title": "Headline"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "invalid_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Invalid At"
          },
          "is_locked": {
            "default": false,
            "title": "Is Locked",
            "type": "boolean"
          },
          "kg_extracted": {
            "default": false,
            "title": "Kg Extracted",
            "type": "boolean"
          },
          "layer": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Canonical product lifecycle layer (Q6/WS-K); derived from memory_tier at serialization only.",
            "readOnly": true,
            "title": "Layer"
          },
          "manually_added": {
            "default": false,
            "title": "Manually Added",
            "type": "boolean"
          },
          "memory_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Memory Id"
          },
          "memory_tier": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MemoryLayer"
              },
              {
                "type": "null"
              }
            ]
          },
          "object_entity_ids": {
            "description": "Stable entity ids referenced by the fact arguments",
            "items": {
              "type": "string"
            },
            "title": "Object Entity Ids",
            "type": "array"
          },
          "predicate": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Canonical relation for the fact, e.g. resides_in, works_at, prefers",
            "title": "Predicate"
          },
          "primary_capture_device": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Primary Capture Device"
          },
          "qualifiers": {
            "additionalProperties": true,
            "description": "Optional proposition qualifiers such as scope, valid_time, or epistemic_status",
            "title": "Qualifiers",
            "type": "object"
          },
          "reviewed": {
            "default": false,
            "title": "Reviewed",
            "type": "boolean"
          },
          "scoring": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scoring"
          },
          "subject_attribution": {
            "$ref": "#/components/schemas/SubjectAttribution",
            "default": "unknown",
            "description": "How the memory subject was attributed"
          },
          "subject_entity_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Stable entity id for who/what the fact is about",
            "title": "Subject Entity Id"
          },
          "superseded_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Superseded By"
          },
          "tags": {
            "description": "The tags of the memory and learning",
            "items": {
              "type": "string"
            },
            "title": "Tags",
            "type": "array"
          },
          "uid": {
            "title": "Uid",
            "type": "string"
          },
          "uncertainty_reasons": {
            "description": "Reasons this fact needs caution or review",
            "items": {
              "type": "string"
            },
            "title": "Uncertainty Reasons",
            "type": "array"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          },
          "user_review": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Review"
          },
          "valid_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Valid At"
          },
          "veracity": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Current belief that the fact is true",
            "title": "Veracity"
          },
          "visibility": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "public",
            "title": "Visibility"
          }
        },
        "required": [
          "content",
          "id",
          "uid",
          "created_at",
          "updated_at",
          "layer"
        ],
        "title": "MemoryDB",
        "type": "object"
      },
      "MemoryLayer": {
        "enum": [
          "short_term",
          "long_term",
          "archive"
        ],
        "title": "MemoryLayer",
        "type": "string"
      },
      "MemoryMutationResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "MemoryMutationResponse",
        "type": "object"
      },
      "MemoryReviewItemResponse": {
        "additionalProperties": true,
        "properties": {
          "review_id": {
            "title": "Review Id",
            "type": "string"
          },
          "status": {
            "default": "pending",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "review_id"
        ],
        "title": "MemoryReviewItemResponse",
        "type": "object"
      },
      "MemorySummaryRatingResponse": {
        "properties": {
          "has_rating": {
            "title": "Has Rating",
            "type": "boolean"
          },
          "rating": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rating"
          }
        },
        "required": [
          "has_rating"
        ],
        "title": "MemorySummaryRatingResponse",
        "type": "object"
      },
      "MemoryValueRequest": {
        "additionalProperties": false,
        "description": "Canonical body for single-value memory mutations.",
        "properties": {
          "value": {
            "title": "Value",
            "type": "string"
          }
        },
        "required": [
          "value"
        ],
        "title": "MemoryValueRequest",
        "type": "object"
      },
      "MentorNotificationSettingsResponse": {
        "properties": {
          "frequency": {
            "title": "Frequency",
            "type": "integer"
          }
        },
        "required": [
          "frequency"
        ],
        "title": "MentorNotificationSettingsResponse",
        "type": "object"
      },
      "MentorNotificationSettingsUpdate": {
        "properties": {
          "frequency": {
            "title": "Frequency",
            "type": "integer"
          }
        },
        "required": [
          "frequency"
        ],
        "title": "MentorNotificationSettingsUpdate",
        "type": "object"
      },
      "MergeConversationsRequest": {
        "description": "Request model for merging multiple conversations.",
        "properties": {
          "conversation_ids": {
            "description": "IDs of conversations to merge (minimum 2)",
            "items": {
              "type": "string"
            },
            "minItems": 2,
            "title": "Conversation Ids",
            "type": "array"
          },
          "reprocess": {
            "default": true,
            "description": "Whether to regenerate summary from merged transcript",
            "title": "Reprocess",
            "type": "boolean"
          }
        },
        "required": [
          "conversation_ids"
        ],
        "title": "MergeConversationsRequest",
        "type": "object"
      },
      "MergeConversationsResponse": {
        "description": "Response model for merge initiation.",
        "properties": {
          "conversation_ids": {
            "description": "All conversation IDs being merged",
            "items": {
              "type": "string"
            },
            "title": "Conversation Ids",
            "type": "array"
          },
          "message": {
            "default": "Merge started",
            "description": "Status message",
            "title": "Message",
            "type": "string"
          },
          "status": {
            "default": "merging",
            "description": "Current merge status",
            "title": "Status",
            "type": "string"
          },
          "warning": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Warning message (e.g., large time gaps)",
            "title": "Warning"
          }
        },
        "required": [
          "conversation_ids"
        ],
        "title": "MergeConversationsResponse",
        "type": "object"
      },
      "Message": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "chart_data": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ChartData"
              },
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chart Data"
          },
          "chat_session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Session Id"
          },
          "client_message_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Message Id"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "files": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/FileChat"
            },
            "title": "Files",
            "type": "array"
          },
          "files_id": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Files Id",
            "type": "array"
          },
          "from_external_integration": {
            "default": false,
            "title": "From External Integration",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "journal_revision": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Journal Revision"
          },
          "langsmith_run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Langsmith Run Id"
          },
          "memories": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/MessageConversation"
            },
            "title": "Memories",
            "type": "array"
          },
          "memories_id": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Memories Id",
            "type": "array"
          },
          "message_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message Source"
          },
          "metadata": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Metadata"
          },
          "plugin_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plugin Id"
          },
          "prompt_commit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Commit"
          },
          "prompt_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Name"
          },
          "rating": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rating"
          },
          "report_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Report Reason"
          },
          "reported": {
            "default": false,
            "title": "Reported",
            "type": "boolean"
          },
          "sender": {
            "$ref": "#/components/schemas/MessageSender"
          },
          "session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Id"
          },
          "text": {
            "title": "Text",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/MessageType"
          }
        },
        "required": [
          "id",
          "text",
          "created_at",
          "sender",
          "type"
        ],
        "title": "Message",
        "type": "object"
      },
      "MessageConversation": {
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "structured": {
            "$ref": "#/components/schemas/MessageConversationStructured"
          }
        },
        "required": [
          "id",
          "structured",
          "created_at"
        ],
        "title": "MessageConversation",
        "type": "object"
      },
      "MessageConversationStructured": {
        "properties": {
          "emoji": {
            "title": "Emoji",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "emoji"
        ],
        "title": "MessageConversationStructured",
        "type": "object"
      },
      "MessageReportResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          }
        },
        "required": [
          "message"
        ],
        "title": "MessageReportResponse",
        "type": "object"
      },
      "MessageSender": {
        "enum": [
          "ai",
          "human"
        ],
        "title": "MessageSender",
        "type": "string"
      },
      "MessageType": {
        "enum": [
          "text",
          "day_summary"
        ],
        "title": "MessageType",
        "type": "string"
      },
      "MigrationRequest": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "target_level": {
            "title": "Target Level",
            "type": "string"
          },
          "type": {
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "type",
          "id",
          "target_level"
        ],
        "title": "MigrationRequest",
        "type": "object"
      },
      "MigrationRequestsResponse": {
        "properties": {
          "needs_migration": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Needs Migration",
            "type": "array"
          }
        },
        "title": "MigrationRequestsResponse",
        "type": "object"
      },
      "MigrationStatusResponse": {
        "properties": {
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "MigrationStatusResponse",
        "type": "object"
      },
      "MigrationTargetRequest": {
        "properties": {
          "target_level": {
            "title": "Target Level",
            "type": "string"
          }
        },
        "required": [
          "target_level"
        ],
        "title": "MigrationTargetRequest",
        "type": "object"
      },
      "MoveConversationRequest": {
        "description": "Request model for moving a conversation to a folder.",
        "properties": {
          "folder_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Folder Id"
          }
        },
        "title": "MoveConversationRequest",
        "type": "object"
      },
      "NormalizedContextMatch": {
        "additionalProperties": false,
        "properties": {
          "signals": {
            "items": {
              "$ref": "#/components/schemas/ContextMatchSignal"
            },
            "maxItems": 4,
            "minItems": 1,
            "title": "Signals",
            "type": "array"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/RecommendationSubjectKind"
          }
        },
        "required": [
          "subject_kind",
          "subject_id",
          "signals"
        ],
        "title": "NormalizedContextMatch",
        "type": "object"
      },
      "NormalizedContextSnapshot": {
        "additionalProperties": false,
        "description": "A bounded local match result; raw local context has no field to enter through.",
        "properties": {
          "device_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Device Id",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "generated_at": {
            "format": "date-time",
            "title": "Generated At",
            "type": "string"
          },
          "matches": {
            "items": {
              "$ref": "#/components/schemas/NormalizedContextMatch"
            },
            "maxItems": 32,
            "title": "Matches",
            "type": "array"
          },
          "schema_version": {
            "const": 1,
            "default": 1,
            "title": "Schema Version",
            "type": "integer"
          },
          "snapshot_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Snapshot Id",
            "type": "string"
          }
        },
        "required": [
          "device_id",
          "snapshot_id",
          "generated_at",
          "expires_at"
        ],
        "title": "NormalizedContextSnapshot",
        "type": "object"
      },
      "NotificationSettingsResponse": {
        "properties": {
          "enabled": {
            "title": "Enabled",
            "type": "boolean"
          },
          "frequency": {
            "title": "Frequency",
            "type": "integer"
          }
        },
        "required": [
          "enabled",
          "frequency"
        ],
        "title": "NotificationSettingsResponse",
        "type": "object"
      },
      "OAuthUrlResponse": {
        "description": "Response containing OAuth authorization URL",
        "properties": {
          "auth_url": {
            "description": "OAuth authorization URL to open in browser",
            "title": "Auth Url",
            "type": "string"
          }
        },
        "required": [
          "auth_url"
        ],
        "title": "OAuthUrlResponse",
        "type": "object"
      },
      "OnboardingStateResponse": {
        "properties": {
          "acquisition_source": {
            "default": "",
            "title": "Acquisition Source",
            "type": "string"
          },
          "completed": {
            "default": false,
            "title": "Completed",
            "type": "boolean"
          },
          "device_onboarding_completed": {
            "default": false,
            "title": "Device Onboarding Completed",
            "type": "boolean"
          }
        },
        "title": "OnboardingStateResponse",
        "type": "object"
      },
      "OnboardingStateUpdate": {
        "properties": {
          "acquisition_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Acquisition Source"
          },
          "completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed"
          },
          "device_onboarding_completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Onboarding Completed"
          }
        },
        "title": "OnboardingStateUpdate",
        "type": "object"
      },
      "OpenLoopDescriptor": {
        "additionalProperties": false,
        "properties": {
          "blocking_on_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Blocking On Id"
          },
          "kind": {
            "$ref": "#/components/schemas/OpenLoopKind"
          },
          "loop_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Loop Id",
            "type": "string"
          },
          "next_action_code": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Next Action Code",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/OpenLoopStatus"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          }
        },
        "required": [
          "loop_id",
          "kind",
          "subject_id",
          "status",
          "next_action_code",
          "updated_at"
        ],
        "title": "OpenLoopDescriptor",
        "type": "object"
      },
      "OpenLoopKind": {
        "enum": [
          "task",
          "artifact",
          "decision",
          "approval",
          "external_wait"
        ],
        "title": "OpenLoopKind",
        "type": "string"
      },
      "OpenLoopSnapshot": {
        "additionalProperties": false,
        "properties": {
          "checkpoint_ref": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Checkpoint Ref"
          },
          "context_packet_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Context Packet Version",
            "type": "string"
          },
          "conversation_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Conversation Id",
            "type": "string"
          },
          "device_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Device Id",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "generated_at": {
            "format": "date-time",
            "title": "Generated At",
            "type": "string"
          },
          "open_loop_snapshot": {
            "items": {
              "$ref": "#/components/schemas/OpenLoopDescriptor"
            },
            "maxItems": 32,
            "title": "Open Loop Snapshot",
            "type": "array"
          },
          "owner": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Owner",
            "type": "string"
          },
          "runtime_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Runtime Id",
            "type": "string"
          },
          "schema_version": {
            "const": 1,
            "default": 1,
            "title": "Schema Version",
            "type": "integer"
          },
          "workstream_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Workstream Id",
            "type": "string"
          }
        },
        "required": [
          "device_id",
          "owner",
          "runtime_id",
          "workstream_id",
          "conversation_id",
          "context_packet_version",
          "generated_at",
          "expires_at"
        ],
        "title": "OpenLoopSnapshot",
        "type": "object"
      },
      "OpenLoopStatus": {
        "enum": [
          "open",
          "blocked",
          "awaiting_user",
          "awaiting_external"
        ],
        "title": "OpenLoopStatus",
        "type": "string"
      },
      "OutcomeCreate": {
        "additionalProperties": false,
        "properties": {
          "attribution_chain_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Attribution Chain Id",
            "type": "string"
          },
          "outcome_code": {
            "$ref": "#/components/schemas/TaskIntelligenceOutcomeCode"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          }
        },
        "required": [
          "attribution_chain_id",
          "subject_kind",
          "subject_id",
          "outcome_code"
        ],
        "title": "OutcomeCreate",
        "type": "object"
      },
      "OutcomeRecord": {
        "additionalProperties": false,
        "properties": {
          "attribution_chain_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Attribution Chain Id",
            "type": "string"
          },
          "occurred_at": {
            "format": "date-time",
            "title": "Occurred At",
            "type": "string"
          },
          "outcome_code": {
            "$ref": "#/components/schemas/TaskIntelligenceOutcomeCode"
          },
          "outcome_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Outcome Id",
            "type": "string"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          }
        },
        "required": [
          "attribution_chain_id",
          "subject_kind",
          "subject_id",
          "outcome_code",
          "outcome_id",
          "occurred_at"
        ],
        "title": "OutcomeRecord",
        "type": "object"
      },
      "OverageInfoResponse": {
        "properties": {
          "byok_available": {
            "default": true,
            "title": "Byok Available",
            "type": "boolean"
          },
          "excess_questions": {
            "default": 0,
            "title": "Excess Questions",
            "type": "integer"
          },
          "explainer_body": {
            "title": "Explainer Body",
            "type": "string"
          },
          "explainer_title": {
            "title": "Explainer Title",
            "type": "string"
          },
          "included_cost_usd": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Included Cost Usd"
          },
          "included_questions": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Included Questions"
          },
          "is_overage_plan": {
            "title": "Is Overage Plan",
            "type": "boolean"
          },
          "markup_multiplier": {
            "title": "Markup Multiplier",
            "type": "number"
          },
          "markup_percent": {
            "title": "Markup Percent",
            "type": "number"
          },
          "overage_usd": {
            "default": 0,
            "title": "Overage Usd",
            "type": "number"
          },
          "plan": {
            "title": "Plan",
            "type": "string"
          },
          "plan_type": {
            "title": "Plan Type",
            "type": "string"
          },
          "provider_reference_rates": {
            "additionalProperties": true,
            "title": "Provider Reference Rates",
            "type": "object"
          },
          "real_cost_usd": {
            "default": 0,
            "title": "Real Cost Usd",
            "type": "number"
          },
          "reset_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reset At"
          },
          "used_questions": {
            "default": 0,
            "title": "Used Questions",
            "type": "integer"
          }
        },
        "required": [
          "plan",
          "plan_type",
          "is_overage_plan",
          "markup_multiplier",
          "markup_percent",
          "explainer_title",
          "explainer_body",
          "provider_reference_rates"
        ],
        "title": "OverageInfoResponse",
        "type": "object"
      },
      "PageContext": {
        "description": "Page context for chat - indicates what the user is currently viewing.",
        "properties": {
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "type": {
            "enum": [
              "conversation",
              "task",
              "memory",
              "recap"
            ],
            "title": "Type",
            "type": "string"
          }
        },
        "required": [
          "type"
        ],
        "title": "PageContext",
        "type": "object"
      },
      "PayPalPaymentDetailsResponse": {
        "properties": {
          "email": {
            "title": "Email",
            "type": "string"
          },
          "paypalme_url": {
            "title": "Paypalme Url",
            "type": "string"
          }
        },
        "required": [
          "email",
          "paypalme_url"
        ],
        "title": "PayPalPaymentDetailsResponse",
        "type": "object"
      },
      "PaymentCheckoutSessionResponse": {
        "properties": {
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "next_billing_date": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Billing Date"
          },
          "session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Id"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          }
        },
        "title": "PaymentCheckoutSessionResponse",
        "type": "object"
      },
      "PaymentMethodStatusResponse": {
        "properties": {
          "default": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default"
          },
          "paypal": {
            "title": "Paypal",
            "type": "string"
          },
          "stripe": {
            "title": "Stripe",
            "type": "string"
          }
        },
        "required": [
          "stripe",
          "paypal"
        ],
        "title": "PaymentMethodStatusResponse",
        "type": "object"
      },
      "PaymentMutationResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "PaymentMutationResponse",
        "type": "object"
      },
      "PaymentStatusMessageResponse": {
        "properties": {
          "message": {
            "title": "Message",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "message"
        ],
        "title": "PaymentStatusMessageResponse",
        "type": "object"
      },
      "PaymentSubscriptionResponse": {
        "properties": {
          "cancel_at_period_end": {
            "default": false,
            "title": "Cancel At Period End",
            "type": "boolean"
          },
          "current_period_end": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period End"
          },
          "current_period_start": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period Start"
          },
          "current_price_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Price Id"
          },
          "deprecated": {
            "default": false,
            "title": "Deprecated",
            "type": "boolean"
          },
          "deprecation_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Deprecation Message"
          },
          "features": {
            "items": {
              "type": "string"
            },
            "title": "Features",
            "type": "array"
          },
          "limits": {
            "$ref": "#/components/schemas/PlanLimits"
          },
          "plan": {
            "default": "basic",
            "title": "Plan",
            "type": "string"
          },
          "status": {
            "default": "active",
            "title": "Status",
            "type": "string"
          },
          "stripe_subscription_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stripe Subscription Id"
          }
        },
        "title": "PaymentSubscriptionResponse",
        "type": "object"
      },
      "PaymentUpgradeSubscriptionResponse": {
        "properties": {
          "days_remaining": {
            "title": "Days Remaining",
            "type": "integer"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "schedule_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Schedule Id"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "subscription": {
            "$ref": "#/components/schemas/PaymentSubscriptionResponse"
          }
        },
        "required": [
          "status",
          "message",
          "subscription",
          "days_remaining"
        ],
        "title": "PaymentUpgradeSubscriptionResponse",
        "type": "object"
      },
      "PaywallStatusResponse": {
        "properties": {
          "paywalled": {
            "title": "Paywalled",
            "type": "boolean"
          }
        },
        "required": [
          "paywalled"
        ],
        "title": "PaywallStatusResponse",
        "type": "object"
      },
      "PendingSyncResponse": {
        "properties": {
          "pending_export": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Pending Export",
            "type": "array"
          },
          "synced_items": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Synced Items",
            "type": "array"
          }
        },
        "required": [
          "pending_export",
          "synced_items"
        ],
        "title": "PendingSyncResponse",
        "type": "object"
      },
      "Person": {
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "speech_sample_transcripts": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speech Sample Transcripts"
          },
          "speech_samples": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Speech Samples",
            "type": "array"
          },
          "speech_samples_version": {
            "default": 3,
            "title": "Speech Samples Version",
            "type": "integer"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "title": "Person",
        "type": "object"
      },
      "PhoneCallQuota": {
        "description": "Phone call feature access + remaining-quota snapshot for the client.",
        "properties": {
          "allowed_countries": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Allowed Countries",
            "type": "array"
          },
          "has_access": {
            "title": "Has Access",
            "type": "boolean"
          },
          "is_paid": {
            "title": "Is Paid",
            "type": "boolean"
          },
          "max_duration_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Duration Seconds"
          },
          "monthly_limit": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Monthly Limit"
          },
          "monthly_used": {
            "default": 0,
            "title": "Monthly Used",
            "type": "integer"
          },
          "remaining": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Remaining"
          },
          "reset_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reset At"
          }
        },
        "required": [
          "has_access",
          "is_paid"
        ],
        "title": "PhoneCallQuota",
        "type": "object"
      },
      "PhoneMutationResponse": {
        "properties": {
          "success": {
            "title": "Success",
            "type": "boolean"
          }
        },
        "required": [
          "success"
        ],
        "title": "PhoneMutationResponse",
        "type": "object"
      },
      "PhoneNumberResponse": {
        "properties": {
          "friendly_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Friendly Name"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "is_primary": {
            "title": "Is Primary",
            "type": "boolean"
          },
          "phone_number": {
            "title": "Phone Number",
            "type": "string"
          },
          "verified_at": {
            "title": "Verified At",
            "type": "string"
          }
        },
        "required": [
          "id",
          "phone_number",
          "verified_at",
          "is_primary"
        ],
        "title": "PhoneNumberResponse",
        "type": "object"
      },
      "PhoneNumbersResponse": {
        "properties": {
          "numbers": {
            "items": {
              "$ref": "#/components/schemas/PhoneNumberResponse"
            },
            "title": "Numbers",
            "type": "array"
          }
        },
        "required": [
          "numbers"
        ],
        "title": "PhoneNumbersResponse",
        "type": "object"
      },
      "PlanLimits": {
        "properties": {
          "chat_cost_usd_per_month": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Cost Usd Per Month"
          },
          "chat_questions_per_month": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Questions Per Month"
          },
          "insights_gained": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Insights Gained"
          },
          "transcription_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Transcription Seconds"
          },
          "words_transcribed": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Words Transcribed"
          }
        },
        "title": "PlanLimits",
        "type": "object"
      },
      "PlanType": {
        "enum": [
          "basic",
          "unlimited",
          "architect",
          "operator",
          "plus",
          "unlimited_v2"
        ],
        "title": "PlanType",
        "type": "string"
      },
      "PluginResult": {
        "properties": {
          "content": {
            "title": "Content",
            "type": "string"
          },
          "plugin_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plugin Id"
          }
        },
        "required": [
          "plugin_id",
          "content"
        ],
        "title": "PluginResult",
        "type": "object"
      },
      "PricingOption": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "price_string": {
            "title": "Price String",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "price_string"
        ],
        "title": "PricingOption",
        "type": "object"
      },
      "PrivateCloudSyncResponse": {
        "properties": {
          "private_cloud_sync_enabled": {
            "title": "Private Cloud Sync Enabled",
            "type": "boolean"
          }
        },
        "required": [
          "private_cloud_sync_enabled"
        ],
        "title": "PrivateCloudSyncResponse",
        "type": "object"
      },
      "ProactiveNotification": {
        "properties": {
          "scopes": {
            "items": {
              "type": "string"
            },
            "title": "Scopes",
            "type": "array",
            "uniqueItems": true
          }
        },
        "required": [
          "scopes"
        ],
        "title": "ProactiveNotification",
        "type": "object"
      },
      "ProcessConversationRequest": {
        "properties": {
          "calendar_meeting_context": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CalendarMeetingContext"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "ProcessConversationRequest",
        "type": "object"
      },
      "ProgressExtractRequest": {
        "description": "Request to extract progress from text.",
        "properties": {
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "title": "ProgressExtractRequest",
        "type": "object"
      },
      "ProgressExtractResponse": {
        "properties": {
          "reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason"
          },
          "updated": {
            "title": "Updated",
            "type": "boolean"
          },
          "updates": {
            "items": {
              "$ref": "#/components/schemas/ProgressExtractUpdateResponse"
            },
            "title": "Updates",
            "type": "array"
          }
        },
        "required": [
          "updated"
        ],
        "title": "ProgressExtractResponse",
        "type": "object"
      },
      "ProgressExtractUpdateResponse": {
        "properties": {
          "goal_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "goal_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Title"
          },
          "new_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "integer"
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "New Value"
          },
          "previous_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "integer"
              },
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Previous Value"
          },
          "reasoning": {
            "default": "",
            "title": "Reasoning",
            "type": "string"
          }
        },
        "title": "ProgressExtractUpdateResponse",
        "type": "object"
      },
      "PublicFairUseCaseStatusResponse": {
        "properties": {
          "case_ref": {
            "title": "Case Ref",
            "type": "string"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "stage": {
            "title": "Stage",
            "type": "string"
          },
          "support_email": {
            "title": "Support Email",
            "type": "string"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          }
        },
        "required": [
          "case_ref",
          "stage",
          "message",
          "support_email"
        ],
        "title": "PublicFairUseCaseStatusResponse",
        "type": "object"
      },
      "RateMessageRequest": {
        "properties": {
          "rating": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rating"
          }
        },
        "title": "RateMessageRequest",
        "type": "object"
      },
      "RebuildResponse": {
        "properties": {
          "edges_count": {
            "title": "Edges Count",
            "type": "integer"
          },
          "nodes_count": {
            "title": "Nodes Count",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "nodes_count",
          "edges_count"
        ],
        "title": "RebuildResponse",
        "type": "object"
      },
      "Recommendation": {
        "additionalProperties": false,
        "properties": {
          "alternative_action": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Alternative Action"
          },
          "dedupe_key": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Dedupe Key",
            "type": "string"
          },
          "destination_task_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Destination Task Id"
          },
          "destination_workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Destination Workstream Id"
          },
          "evidence_preview": {
            "maxLength": 512,
            "title": "Evidence Preview",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "feedback_subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Feedback Subject Id",
            "type": "string"
          },
          "feedback_subject_kind": {
            "$ref": "#/components/schemas/FeedbackSubjectKind"
          },
          "goal_or_workstream_label": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Or Workstream Label"
          },
          "headline": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Headline",
            "type": "string"
          },
          "intervention_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Intervention Id",
            "type": "string"
          },
          "output_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Output Version",
            "type": "string"
          },
          "recommended_action": {
            "maxLength": 128,
            "minLength": 1,
            "title": "Recommended Action",
            "type": "string"
          },
          "subject_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Subject Id",
            "type": "string"
          },
          "subject_kind": {
            "$ref": "#/components/schemas/RecommendationSubjectKind"
          },
          "why_now": {
            "maxLength": 1024,
            "minLength": 1,
            "title": "Why Now",
            "type": "string"
          }
        },
        "required": [
          "intervention_id",
          "output_version",
          "subject_kind",
          "subject_id",
          "feedback_subject_kind",
          "feedback_subject_id",
          "headline",
          "why_now",
          "recommended_action",
          "evidence_preview",
          "evidence_refs",
          "dedupe_key",
          "expires_at"
        ],
        "title": "Recommendation",
        "type": "object"
      },
      "RecommendationSubjectKind": {
        "enum": [
          "candidate",
          "task",
          "workstream",
          "artifact",
          "decision",
          "agent_open_loop"
        ],
        "title": "RecommendationSubjectKind",
        "type": "string"
      },
      "RecordLlmUsageBucketRequest": {
        "properties": {
          "account": {
            "default": "omi",
            "maxLength": 100,
            "title": "Account",
            "type": "string"
          },
          "cache_read_tokens": {
            "default": 0,
            "minimum": 0,
            "title": "Cache Read Tokens",
            "type": "integer"
          },
          "cache_write_tokens": {
            "default": 0,
            "minimum": 0,
            "title": "Cache Write Tokens",
            "type": "integer"
          },
          "cost_usd": {
            "default": 0,
            "minimum": 0,
            "title": "Cost Usd",
            "type": "number"
          },
          "input_tokens": {
            "default": 0,
            "minimum": 0,
            "title": "Input Tokens",
            "type": "integer"
          },
          "output_tokens": {
            "default": 0,
            "minimum": 0,
            "title": "Output Tokens",
            "type": "integer"
          },
          "total_tokens": {
            "default": 0,
            "minimum": 0,
            "title": "Total Tokens",
            "type": "integer"
          }
        },
        "title": "RecordLlmUsageBucketRequest",
        "type": "object"
      },
      "ReorderFoldersRequest": {
        "description": "Request model for reordering folders.",
        "properties": {
          "folder_ids": {
            "items": {
              "type": "string"
            },
            "maxItems": 100,
            "minItems": 1,
            "title": "Folder Ids",
            "type": "array"
          }
        },
        "required": [
          "folder_ids"
        ],
        "title": "ReorderFoldersRequest",
        "type": "object"
      },
      "ReplyToReviewRequest": {
        "properties": {
          "response": {
            "title": "Response",
            "type": "string"
          },
          "reviewer_uid": {
            "title": "Reviewer Uid",
            "type": "string"
          }
        },
        "required": [
          "reviewer_uid",
          "response"
        ],
        "title": "ReplyToReviewRequest",
        "type": "object"
      },
      "ResponseMessage": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "ask_for_nps": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Ask For Nps"
          },
          "chart_data": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ChartData"
              },
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chart Data"
          },
          "chat_session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Session Id"
          },
          "client_message_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Message Id"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "files": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/FileChat"
            },
            "title": "Files",
            "type": "array"
          },
          "files_id": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Files Id",
            "type": "array"
          },
          "from_external_integration": {
            "default": false,
            "title": "From External Integration",
            "type": "boolean"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "journal_revision": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Journal Revision"
          },
          "langsmith_run_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Langsmith Run Id"
          },
          "memories": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/MessageConversation"
            },
            "title": "Memories",
            "type": "array"
          },
          "memories_id": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Memories Id",
            "type": "array"
          },
          "message_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message Source"
          },
          "metadata": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Metadata"
          },
          "plugin_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Plugin Id"
          },
          "prompt_commit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Commit"
          },
          "prompt_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Prompt Name"
          },
          "rating": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rating"
          },
          "report_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Report Reason"
          },
          "reported": {
            "default": false,
            "title": "Reported",
            "type": "boolean"
          },
          "sender": {
            "$ref": "#/components/schemas/MessageSender"
          },
          "session_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Session Id"
          },
          "text": {
            "title": "Text",
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/MessageType"
          }
        },
        "required": [
          "id",
          "text",
          "created_at",
          "sender",
          "type"
        ],
        "title": "ResponseMessage",
        "type": "object"
      },
      "ReviewAppRequest": {
        "properties": {
          "response": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Response"
          },
          "review": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Review"
          },
          "score": {
            "title": "Score",
            "type": "number"
          },
          "username": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Username"
          }
        },
        "required": [
          "score"
        ],
        "title": "ReviewAppRequest",
        "type": "object"
      },
      "ReviewResolutionRequest": {
        "properties": {
          "correction": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Correction"
          },
          "current_veracity": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Veracity"
          },
          "decision": {
            "description": "accept, reject, correct, or timeout",
            "title": "Decision",
            "type": "string"
          },
          "reason": {
            "default": "",
            "title": "Reason",
            "type": "string"
          }
        },
        "required": [
          "decision"
        ],
        "title": "ReviewResolutionRequest",
        "type": "object"
      },
      "ReviewResolutionResponse": {
        "additionalProperties": true,
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "ReviewResolutionResponse",
        "type": "object"
      },
      "SaveFcmTokenRequest": {
        "properties": {
          "fcm_token": {
            "title": "Fcm Token",
            "type": "string"
          },
          "time_zone": {
            "title": "Time Zone",
            "type": "string"
          }
        },
        "required": [
          "fcm_token",
          "time_zone"
        ],
        "title": "SaveFcmTokenRequest",
        "type": "object"
      },
      "SavePayPalPaymentDetailsRequest": {
        "properties": {
          "email": {
            "title": "Email",
            "type": "string"
          },
          "paypalme_url": {
            "title": "Paypalme Url",
            "type": "string"
          }
        },
        "required": [
          "email",
          "paypalme_url"
        ],
        "title": "SavePayPalPaymentDetailsRequest",
        "type": "object"
      },
      "SearchConversationsResponse": {
        "properties": {
          "current_page": {
            "title": "Current Page",
            "type": "integer"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/Conversation"
            },
            "title": "Items",
            "type": "array"
          },
          "per_page": {
            "title": "Per Page",
            "type": "integer"
          },
          "total_pages": {
            "title": "Total Pages",
            "type": "integer"
          }
        },
        "required": [
          "items",
          "total_pages",
          "current_page",
          "per_page"
        ],
        "title": "SearchConversationsResponse",
        "type": "object"
      },
      "SearchRequest": {
        "properties": {
          "end_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "End Date"
          },
          "include_discarded": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": true,
            "title": "Include Discarded"
          },
          "page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": 1,
            "title": "Page"
          },
          "per_page": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": 10,
            "title": "Per Page"
          },
          "query": {
            "default": "",
            "title": "Query",
            "type": "string"
          },
          "speaker_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speaker Id"
          },
          "start_date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start Date"
          }
        },
        "title": "SearchRequest",
        "type": "object"
      },
      "SearchedMemory": {
        "properties": {
          "archive_default_visible": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Archive Default Visible"
          },
          "category": {
            "$ref": "#/components/schemas/MemoryCategory"
          },
          "category_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category Source"
          },
          "content": {
            "title": "Content",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "manually_added": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Manually Added"
          },
          "manually_added_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Manually Added Source"
          },
          "memory_default_memory": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Memory Default Memory"
          },
          "policy": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Policy"
          },
          "relevance_score": {
            "title": "Relevance Score",
            "type": "number"
          },
          "reviewed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reviewed"
          },
          "reviewed_source": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reviewed Source"
          }
        },
        "required": [
          "id",
          "content",
          "category",
          "relevance_score"
        ],
        "title": "SearchedMemory",
        "type": "object"
      },
      "SendMessageRequest": {
        "properties": {
          "context": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PageContext"
              },
              {
                "type": "null"
              }
            ]
          },
          "file_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": [],
            "title": "File Ids"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "text"
        ],
        "title": "SendMessageRequest",
        "type": "object"
      },
      "SetConversationActionItemsStateRequest": {
        "properties": {
          "items_idx": {
            "items": {
              "type": "integer"
            },
            "title": "Items Idx",
            "type": "array"
          },
          "values": {
            "items": {
              "type": "boolean"
            },
            "title": "Values",
            "type": "array"
          }
        },
        "required": [
          "items_idx",
          "values"
        ],
        "title": "SetConversationActionItemsStateRequest",
        "type": "object"
      },
      "SetConversationEventsStateRequest": {
        "properties": {
          "events_idx": {
            "items": {
              "type": "integer"
            },
            "title": "Events Idx",
            "type": "array"
          },
          "values": {
            "items": {
              "type": "boolean"
            },
            "title": "Values",
            "type": "array"
          }
        },
        "required": [
          "events_idx",
          "values"
        ],
        "title": "SetConversationEventsStateRequest",
        "type": "object"
      },
      "SetDefaultPaymentMethodRequest": {
        "properties": {
          "method": {
            "title": "Method",
            "type": "string"
          }
        },
        "required": [
          "method"
        ],
        "title": "SetDefaultPaymentMethodRequest",
        "type": "object"
      },
      "SetUserLanguageRequest": {
        "properties": {
          "language": {
            "title": "Language",
            "type": "string"
          }
        },
        "required": [
          "language"
        ],
        "title": "SetUserLanguageRequest",
        "type": "object"
      },
      "SetUserWebhookUrlRequest": {
        "properties": {
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "SetUserWebhookUrlRequest",
        "type": "object"
      },
      "ShareActionItemsResponse": {
        "properties": {
          "token": {
            "title": "Token",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url",
          "token"
        ],
        "title": "ShareActionItemsResponse",
        "type": "object"
      },
      "ShareChatMessagesRequest": {
        "properties": {
          "message_ids": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Message Ids",
            "type": "array"
          }
        },
        "title": "ShareChatMessagesRequest",
        "type": "object"
      },
      "ShareChatMessagesResponse": {
        "properties": {
          "token": {
            "title": "Token",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url",
          "token"
        ],
        "title": "ShareChatMessagesResponse",
        "type": "object"
      },
      "ShareTasksRequest": {
        "properties": {
          "task_ids": {
            "description": "IDs of action items to share",
            "items": {
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Task Ids",
            "type": "array"
          }
        },
        "required": [
          "task_ids"
        ],
        "title": "ShareTasksRequest",
        "type": "object"
      },
      "SharedActionItemPreview": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          }
        },
        "required": [
          "description"
        ],
        "title": "SharedActionItemPreview",
        "type": "object"
      },
      "SharedActionItemsResponse": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "sender_name": {
            "title": "Sender Name",
            "type": "string"
          },
          "tasks": {
            "items": {
              "$ref": "#/components/schemas/SharedActionItemPreview"
            },
            "title": "Tasks",
            "type": "array"
          }
        },
        "required": [
          "sender_name",
          "tasks",
          "count"
        ],
        "title": "SharedActionItemsResponse",
        "type": "object"
      },
      "SharedAssistantSettings": {
        "properties": {
          "analysis_delay": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysis Delay"
          },
          "cooldown_interval": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cooldown Interval"
          },
          "glow_overlay_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Glow Overlay Enabled"
          },
          "screen_analysis_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Screen Analysis Enabled"
          }
        },
        "title": "SharedAssistantSettings",
        "type": "object"
      },
      "SharedChatMessage": {
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "sender": {
            "title": "Sender",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "id",
          "text",
          "sender"
        ],
        "title": "SharedChatMessage",
        "type": "object"
      },
      "SharedChatMessagesResponse": {
        "properties": {
          "count": {
            "title": "Count",
            "type": "integer"
          },
          "messages": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/SharedChatMessage"
            },
            "title": "Messages",
            "type": "array"
          },
          "sender_name": {
            "title": "Sender Name",
            "type": "string"
          }
        },
        "required": [
          "sender_name",
          "count"
        ],
        "title": "SharedChatMessagesResponse",
        "type": "object"
      },
      "SharedConversationResponse": {
        "additionalProperties": true,
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "apps_results": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/AppResult"
            },
            "title": "Apps Results",
            "type": "array"
          },
          "audio_files": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/AudioFile"
            },
            "title": "Audio Files",
            "type": "array"
          },
          "calendar_event": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CalendarEventLink"
              },
              {
                "type": "null"
              }
            ]
          },
          "call_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Twilio call SID for phone call conversations",
            "title": "Call Id"
          },
          "client_device_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Device Id"
          },
          "client_platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Client Platform"
          },
          "conversation_audio": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationAudio"
              },
              {
                "type": "null"
              }
            ]
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "deferred": {
            "default": false,
            "title": "Deferred",
            "type": "boolean"
          },
          "discarded": {
            "default": false,
            "title": "Discarded",
            "type": "boolean"
          },
          "external_data": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "External Data"
          },
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "folder_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "ID of the folder this conversation belongs to",
            "title": "Folder Id"
          },
          "geolocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Geolocation"
              },
              {
                "type": "null"
              }
            ]
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "is_locked": {
            "default": false,
            "title": "Is Locked",
            "type": "boolean"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "people": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/Person"
            },
            "title": "People",
            "type": "array"
          },
          "photos": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/ConversationPhoto"
            },
            "title": "Photos",
            "type": "array"
          },
          "plugins_results": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/PluginResult"
            },
            "title": "Plugins Results",
            "type": "array"
          },
          "private_cloud_sync_enabled": {
            "default": false,
            "title": "Private Cloud Sync Enabled",
            "type": "boolean"
          },
          "processing_conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processing Conversation Id"
          },
          "processing_memory_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Processing Memory Id"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationSource"
              },
              {
                "type": "null"
              }
            ],
            "default": "omi"
          },
          "starred": {
            "default": false,
            "title": "Starred",
            "type": "boolean"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ConversationStatus"
              },
              {
                "type": "null"
              }
            ],
            "default": "completed"
          },
          "structured": {
            "$ref": "#/components/schemas/Structured"
          },
          "suggested_summarization_apps": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Suggested Summarization Apps",
            "type": "array"
          },
          "transcript_segments": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/TranscriptSegment"
            },
            "title": "Transcript Segments",
            "type": "array"
          },
          "transcript_segments_compressed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": false,
            "title": "Transcript Segments Compressed"
          },
          "updated_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated At"
          },
          "visibility": {
            "$ref": "#/components/schemas/ConversationVisibility",
            "default": "private"
          }
        },
        "required": [
          "id",
          "created_at",
          "started_at",
          "finished_at",
          "structured"
        ],
        "title": "SharedConversationResponse",
        "type": "object"
      },
      "ShortlistEligibility": {
        "additionalProperties": false,
        "properties": {
          "inside_due_window": {
            "title": "Inside Due Window",
            "type": "boolean"
          },
          "open": {
            "title": "Open",
            "type": "boolean"
          },
          "passes_recommendation_gates": {
            "title": "Passes Recommendation Gates",
            "type": "boolean"
          },
          "recent_material_activity": {
            "title": "Recent Material Activity",
            "type": "boolean"
          },
          "unexpired": {
            "title": "Unexpired",
            "type": "boolean"
          }
        },
        "required": [
          "open",
          "unexpired",
          "passes_recommendation_gates",
          "recent_material_activity",
          "inside_due_window"
        ],
        "title": "ShortlistEligibility",
        "type": "object"
      },
      "SimpleActionItem": {
        "properties": {
          "completed": {
            "default": false,
            "title": "Completed",
            "type": "boolean"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "conversation_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Conversation Id"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "description": {
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          }
        },
        "required": [
          "id",
          "description"
        ],
        "title": "SimpleActionItem",
        "type": "object"
      },
      "SimpleChatMessage": {
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "sender": {
            "title": "Sender",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Type"
          }
        },
        "required": [
          "id",
          "text",
          "sender"
        ],
        "title": "SimpleChatMessage",
        "type": "object"
      },
      "SimpleConversation": {
        "properties": {
          "finished_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "started_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "structured": {
            "$ref": "#/components/schemas/SimpleStructured"
          }
        },
        "required": [
          "id",
          "started_at",
          "finished_at",
          "structured"
        ],
        "title": "SimpleConversation",
        "type": "object"
      },
      "SimplePerson": {
        "properties": {
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "speech_sample_transcripts": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Speech Sample Transcripts",
            "type": "array"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "title": "SimplePerson",
        "type": "object"
      },
      "SimpleStructured": {
        "properties": {
          "category": {
            "$ref": "#/components/schemas/CategoryEnum"
          },
          "overview": {
            "title": "Overview",
            "type": "string"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "overview",
          "category"
        ],
        "title": "SimpleStructured",
        "type": "object"
      },
      "SimpleTranscriptSegment": {
        "properties": {
          "end": {
            "title": "End",
            "type": "number"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "speaker_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speaker Id"
          },
          "speaker_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speaker Name"
          },
          "start": {
            "title": "Start",
            "type": "number"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "text",
          "start",
          "end"
        ],
        "title": "SimpleTranscriptSegment",
        "type": "object"
      },
      "SnapshotReceipt": {
        "additionalProperties": false,
        "properties": {
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "replaced": {
            "title": "Replaced",
            "type": "boolean"
          },
          "snapshot_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Snapshot Id",
            "type": "string"
          }
        },
        "required": [
          "snapshot_id",
          "replaced",
          "expires_at"
        ],
        "title": "SnapshotReceipt",
        "type": "object"
      },
      "SpeechProfileMutationResponse": {
        "properties": {
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "SpeechProfileMutationResponse",
        "type": "object"
      },
      "SpeechProfileResponse": {
        "properties": {
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          }
        },
        "title": "SpeechProfileResponse",
        "type": "object"
      },
      "SpeechProfileUploadResponse": {
        "properties": {
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "url"
        ],
        "title": "SpeechProfileUploadResponse",
        "type": "object"
      },
      "StatusResponse": {
        "description": "Canonical ack response for `{'status': str}` endpoints (deletes, mutations, bulk ops).\n\nPrefer this over hand-built `{'status': 'ok'}` dicts. Domain-specific status\nresponses (e.g. `IntegrationNotificationResponse`) may stay in their domain\nmodule, but generic acks should use this.",
        "properties": {
          "status": {
            "description": "Human-readable status message, e.g. \"ok\".",
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "StatusResponse",
        "type": "object"
      },
      "StoreMeetingRequest": {
        "description": "Request to store/update a calendar meeting",
        "properties": {
          "calendar_event_id": {
            "description": "External calendar system ID (macOS/Google/Outlook event ID)",
            "title": "Calendar Event Id",
            "type": "string"
          },
          "calendar_source": {
            "description": "Source: 'macos_calendar', 'google_calendar', 'outlook_calendar'",
            "title": "Calendar Source",
            "type": "string"
          },
          "end_time": {
            "description": "Meeting end time",
            "format": "date-time",
            "title": "End Time",
            "type": "string"
          },
          "meeting_link": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "URL to join the meeting",
            "title": "Meeting Link"
          },
          "notes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Meeting notes/description",
            "title": "Notes"
          },
          "participants": {
            "description": "Meeting participants",
            "items": {
              "$ref": "#/components/schemas/MeetingParticipant"
            },
            "title": "Participants",
            "type": "array"
          },
          "platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Platform: 'Zoom', 'Teams', 'Google Meet', etc.",
            "title": "Platform"
          },
          "start_time": {
            "description": "Meeting start time",
            "format": "date-time",
            "title": "Start Time",
            "type": "string"
          },
          "title": {
            "description": "Meeting title",
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "calendar_event_id",
          "calendar_source",
          "title",
          "start_time",
          "end_time"
        ],
        "title": "StoreMeetingRequest",
        "type": "object"
      },
      "StoreMeetingResponse": {
        "description": "Response after storing a meeting",
        "properties": {
          "calendar_event_id": {
            "title": "Calendar Event Id",
            "type": "string"
          },
          "meeting_id": {
            "description": "Firestore document ID for this meeting",
            "title": "Meeting Id",
            "type": "string"
          },
          "message": {
            "default": "Meeting stored successfully",
            "title": "Message",
            "type": "string"
          }
        },
        "required": [
          "meeting_id",
          "calendar_event_id"
        ],
        "title": "StoreMeetingResponse",
        "type": "object"
      },
      "StoreRecordingPermissionResponse": {
        "properties": {
          "store_recording_permission": {
            "title": "Store Recording Permission",
            "type": "boolean"
          }
        },
        "required": [
          "store_recording_permission"
        ],
        "title": "StoreRecordingPermissionResponse",
        "type": "object"
      },
      "StripeConnectAccountResponse": {
        "properties": {
          "account_id": {
            "title": "Account Id",
            "type": "string"
          },
          "url": {
            "title": "Url",
            "type": "string"
          }
        },
        "required": [
          "account_id",
          "url"
        ],
        "title": "StripeConnectAccountResponse",
        "type": "object"
      },
      "StripeOnboardingStatusResponse": {
        "properties": {
          "onboarding_complete": {
            "title": "Onboarding Complete",
            "type": "boolean"
          }
        },
        "required": [
          "onboarding_complete"
        ],
        "title": "StripeOnboardingStatusResponse",
        "type": "object"
      },
      "StripeSupportedCountryResponse": {
        "properties": {
          "id": {
            "title": "Id",
            "type": "string"
          },
          "name": {
            "title": "Name",
            "type": "string"
          }
        },
        "required": [
          "id",
          "name"
        ],
        "title": "StripeSupportedCountryResponse",
        "type": "object"
      },
      "Structured": {
        "properties": {
          "action_items": {
            "description": "A list of action items from the conversation",
            "items": {
              "$ref": "#/components/schemas/ActionItem"
            },
            "title": "Action Items",
            "type": "array"
          },
          "category": {
            "$ref": "#/components/schemas/CategoryEnum",
            "default": "other",
            "description": "A category for this conversation"
          },
          "emoji": {
            "default": "🧠",
            "description": "An emoji to represent the conversation",
            "title": "Emoji",
            "type": "string"
          },
          "events": {
            "description": "A list of events extracted from the conversation, that the user must have on his calendar.",
            "items": {
              "$ref": "#/components/schemas/Event"
            },
            "title": "Events",
            "type": "array"
          },
          "overview": {
            "default": "",
            "description": "A brief overview of the conversation, highlighting the key details from it",
            "title": "Overview",
            "type": "string"
          },
          "title": {
            "default": "",
            "description": "A title/name for this conversation",
            "title": "Title",
            "type": "string"
          }
        },
        "title": "Structured",
        "type": "object"
      },
      "SubjectAttribution": {
        "enum": [
          "user",
          "third_party",
          "unknown",
          "legacy_assumed"
        ],
        "title": "SubjectAttribution",
        "type": "string"
      },
      "Subscription": {
        "properties": {
          "cancel_at_period_end": {
            "default": false,
            "title": "Cancel At Period End",
            "type": "boolean"
          },
          "current_period_end": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period End"
          },
          "current_period_start": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Period Start"
          },
          "current_price_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Price Id"
          },
          "deprecated": {
            "default": false,
            "title": "Deprecated",
            "type": "boolean"
          },
          "deprecation_message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Deprecation Message"
          },
          "features": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Features",
            "type": "array"
          },
          "limits": {
            "$ref": "#/components/schemas/PlanLimits",
            "default": {}
          },
          "plan": {
            "$ref": "#/components/schemas/PlanType",
            "default": "basic",
            "enum": [
              "basic",
              "unlimited",
              "architect",
              "operator"
            ]
          },
          "status": {
            "$ref": "#/components/schemas/SubscriptionStatus",
            "default": "active"
          },
          "stripe_subscription_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stripe Subscription Id"
          }
        },
        "title": "Subscription",
        "type": "object"
      },
      "SubscriptionPlan": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "eyebrow": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Eyebrow"
          },
          "features": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Features",
            "type": "array"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "legacy": {
            "default": false,
            "title": "Legacy",
            "type": "boolean"
          },
          "prices": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/PricingOption"
            },
            "title": "Prices",
            "type": "array"
          },
          "subtitle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subtitle"
          },
          "title": {
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title"
        ],
        "title": "SubscriptionPlan",
        "type": "object"
      },
      "SubscriptionStatus": {
        "enum": [
          "active",
          "inactive"
        ],
        "title": "SubscriptionStatus",
        "type": "string"
      },
      "SyncBatchItem": {
        "properties": {
          "apple_reminder_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Apple Reminder Id"
          },
          "completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "export_platform": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Export Platform"
          },
          "exported": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Exported"
          },
          "id": {
            "title": "Id",
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "title": "SyncBatchItem",
        "type": "object"
      },
      "SyncBatchRequest": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/SyncBatchItem"
            },
            "maxItems": 100,
            "title": "Items",
            "type": "array"
          }
        },
        "required": [
          "items"
        ],
        "title": "SyncBatchRequest",
        "type": "object"
      },
      "SyncCaptureManifestFile": {
        "properties": {
          "name": {
            "maxLength": 255,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "sha256": {
            "pattern": "^[0-9a-fA-F]{64}$",
            "title": "Sha256",
            "type": "string"
          }
        },
        "required": [
          "name",
          "sha256"
        ],
        "title": "SyncCaptureManifestFile",
        "type": "object"
      },
      "SyncCaptureManifestRequest": {
        "properties": {
          "conversation_id": {
            "maxLength": 128,
            "minLength": 1,
            "title": "Conversation Id",
            "type": "string"
          },
          "files": {
            "items": {
              "$ref": "#/components/schemas/SyncCaptureManifestFile"
            },
            "maxItems": 20,
            "minItems": 1,
            "title": "Files",
            "type": "array"
          }
        },
        "required": [
          "conversation_id",
          "files"
        ],
        "title": "SyncCaptureManifestRequest",
        "type": "object"
      },
      "SyncCaptureManifestResponse": {
        "properties": {
          "manifest": {
            "title": "Manifest",
            "type": "string"
          }
        },
        "required": [
          "manifest"
        ],
        "title": "SyncCaptureManifestResponse",
        "type": "object"
      },
      "SyncJobStartResponse": {
        "properties": {
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "lane": {
            "default": "fresh",
            "title": "Lane",
            "type": "string"
          },
          "poll_after_ms": {
            "title": "Poll After Ms",
            "type": "integer"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "total_files": {
            "title": "Total Files",
            "type": "integer"
          },
          "total_segments": {
            "title": "Total Segments",
            "type": "integer"
          }
        },
        "required": [
          "job_id",
          "status",
          "total_files",
          "total_segments",
          "poll_after_ms"
        ],
        "title": "SyncJobStartResponse",
        "type": "object"
      },
      "SyncJobStatusResponse": {
        "properties": {
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "failed_segments": {
            "default": 0,
            "title": "Failed Segments",
            "type": "integer"
          },
          "job_id": {
            "title": "Job Id",
            "type": "string"
          },
          "lane": {
            "default": "fresh",
            "title": "Lane",
            "type": "string"
          },
          "processed_segments": {
            "default": 0,
            "title": "Processed Segments",
            "type": "integer"
          },
          "reason_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reason Code"
          },
          "recording_age_seconds": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recording Age Seconds"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SyncLocalFilesResultResponse"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "successful_segments": {
            "default": 0,
            "title": "Successful Segments",
            "type": "integer"
          },
          "total_segments": {
            "default": 0,
            "title": "Total Segments",
            "type": "integer"
          }
        },
        "required": [
          "job_id",
          "status"
        ],
        "title": "SyncJobStatusResponse",
        "type": "object"
      },
      "SyncLocalFilesResultResponse": {
        "properties": {
          "errors": {
            "items": {
              "type": "string"
            },
            "title": "Errors",
            "type": "array"
          },
          "failed_segments": {
            "default": 0,
            "title": "Failed Segments",
            "type": "integer"
          },
          "new_memories": {
            "items": {
              "type": "string"
            },
            "title": "New Memories",
            "type": "array"
          },
          "total_segments": {
            "default": 0,
            "title": "Total Segments",
            "type": "integer"
          },
          "updated_memories": {
            "items": {
              "type": "string"
            },
            "title": "Updated Memories",
            "type": "array"
          }
        },
        "title": "SyncLocalFilesResultResponse",
        "type": "object"
      },
      "Targeting": {
        "description": "Controls who sees the announcement",
        "properties": {
          "app_version_max": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Version Max"
          },
          "app_version_min": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Version Min"
          },
          "device_models": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Models"
          },
          "firmware_version_max": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Firmware Version Max"
          },
          "firmware_version_min": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Firmware Version Min"
          },
          "platforms": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Platforms"
          },
          "test_uids": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Test Uids"
          },
          "trigger": {
            "$ref": "#/components/schemas/TriggerType",
            "default": "version_upgrade"
          }
        },
        "title": "Targeting",
        "type": "object"
      },
      "TaskAssistantSettings": {
        "properties": {
          "allowed_apps": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Allowed Apps"
          },
          "analysis_prompt": {
            "anyOf": [
              {
                "maxLength": 10000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Analysis Prompt"
          },
          "browser_keywords": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Browser Keywords"
          },
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "extraction_interval": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Extraction Interval"
          },
          "min_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Confidence"
          },
          "notifications_enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Notifications Enabled"
          }
        },
        "title": "TaskAssistantSettings",
        "type": "object"
      },
      "TaskCancelCandidate": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "const": "cancel",
            "default": "cancel",
            "title": "Proposed Action",
            "type": "string"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "subject_kind": {
            "const": "task",
            "default": "task",
            "title": "Subject Kind",
            "type": "string"
          },
          "task_change": {
            "$ref": "#/components/schemas/TaskChangePayload"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "task_id",
          "task_change"
        ],
        "title": "TaskCancelCandidate",
        "type": "object"
      },
      "TaskCandidate": {
        "discriminator": {
          "mapping": {
            "cancel": "#/components/schemas/TaskCancelCandidate",
            "complete": "#/components/schemas/TaskCompleteCandidate",
            "create": "#/components/schemas/TaskCreateCandidate",
            "supersede": "#/components/schemas/TaskSupersedeCandidate",
            "update": "#/components/schemas/TaskUpdateCandidate"
          },
          "propertyName": "proposed_action"
        },
        "oneOf": [
          {
            "$ref": "#/components/schemas/TaskCreateCandidate"
          },
          {
            "$ref": "#/components/schemas/TaskUpdateCandidate"
          },
          {
            "$ref": "#/components/schemas/TaskCompleteCandidate"
          },
          {
            "$ref": "#/components/schemas/TaskCancelCandidate"
          },
          {
            "$ref": "#/components/schemas/TaskSupersedeCandidate"
          }
        ]
      },
      "TaskChangePayload": {
        "additionalProperties": false,
        "properties": {
          "description": {
            "anyOf": [
              {
                "maxLength": 4096,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "due_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due Confidence"
          },
          "owner": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskOwner"
              },
              {
                "type": "null"
              }
            ]
          },
          "priority": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskPriority"
              },
              {
                "type": "null"
              }
            ]
          },
          "recurrence_parent_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Parent Id"
          },
          "recurrence_rule": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Rule"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "superseded_by": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Superseded By"
          }
        },
        "title": "TaskChangePayload",
        "type": "object"
      },
      "TaskCompleteCandidate": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "const": "complete",
            "default": "complete",
            "title": "Proposed Action",
            "type": "string"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "subject_kind": {
            "const": "task",
            "default": "task",
            "title": "Subject Kind",
            "type": "string"
          },
          "task_change": {
            "$ref": "#/components/schemas/TaskChangePayload"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "task_id",
          "task_change"
        ],
        "title": "TaskCompleteCandidate",
        "type": "object"
      },
      "TaskCreateCandidate": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "const": "create",
            "default": "create",
            "title": "Proposed Action",
            "type": "string"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "subject_kind": {
            "const": "task",
            "default": "task",
            "title": "Subject Kind",
            "type": "string"
          },
          "task_change": {
            "$ref": "#/components/schemas/TaskCreatePayload"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "task_change"
        ],
        "title": "TaskCreateCandidate",
        "type": "object"
      },
      "TaskCreatePayload": {
        "additionalProperties": false,
        "description": "Candidate task-create payload; envelope metadata is intentionally absent.",
        "properties": {
          "description": {
            "maxLength": 4096,
            "minLength": 1,
            "title": "Description",
            "type": "string"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due At"
          },
          "due_confidence": {
            "anyOf": [
              {
                "maximum": 1,
                "minimum": 0,
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Due Confidence"
          },
          "owner": {
            "$ref": "#/components/schemas/TaskOwner",
            "default": "unknown"
          },
          "priority": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskPriority"
              },
              {
                "type": "null"
              }
            ]
          },
          "recurrence_parent_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Parent Id"
          },
          "recurrence_rule": {
            "anyOf": [
              {
                "maxLength": 128,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Recurrence Rule"
          }
        },
        "required": [
          "description"
        ],
        "title": "TaskCreatePayload",
        "type": "object"
      },
      "TaskGoalLinkImport": {
        "additionalProperties": false,
        "properties": {
          "goal_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Goal Id",
            "type": "string"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          }
        },
        "required": [
          "task_id",
          "goal_id"
        ],
        "title": "TaskGoalLinkImport",
        "type": "object"
      },
      "TaskGoalLinkImportReport": {
        "properties": {
          "failed": {
            "title": "Failed",
            "type": "integer"
          },
          "failure_task_ids": {
            "items": {
              "maxLength": 128,
              "minLength": 1,
              "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
              "type": "string"
            },
            "title": "Failure Task Ids",
            "type": "array"
          },
          "imported": {
            "title": "Imported",
            "type": "integer"
          },
          "unchanged": {
            "title": "Unchanged",
            "type": "integer"
          }
        },
        "required": [
          "imported",
          "unchanged",
          "failed",
          "failure_task_ids"
        ],
        "title": "TaskGoalLinkImportReport",
        "type": "object"
      },
      "TaskGoalLinkImportRequest": {
        "additionalProperties": false,
        "properties": {
          "links": {
            "items": {
              "$ref": "#/components/schemas/TaskGoalLinkImport"
            },
            "maxItems": 500,
            "title": "Links",
            "type": "array"
          }
        },
        "required": [
          "links"
        ],
        "title": "TaskGoalLinkImportRequest",
        "type": "object"
      },
      "TaskIntegrationData": {
        "description": "Data for a task integration connection",
        "properties": {
          "access_token": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Access Token"
          },
          "connected": {
            "default": true,
            "title": "Connected",
            "type": "boolean"
          },
          "default_list_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default List Id"
          },
          "default_list_title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Default List Title"
          },
          "list_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "List Id"
          },
          "list_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "List Name"
          },
          "project_gid": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Gid"
          },
          "project_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Project Name"
          },
          "refresh_token": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Refresh Token"
          },
          "space_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Space Id"
          },
          "space_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Space Name"
          },
          "team_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Team Id"
          },
          "team_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Team Name"
          },
          "user_gid": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Gid"
          },
          "user_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Id"
          },
          "workspace_gid": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workspace Gid"
          },
          "workspace_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workspace Name"
          }
        },
        "title": "TaskIntegrationData",
        "type": "object"
      },
      "TaskIntegrationMutationResponse": {
        "properties": {
          "app_key": {
            "title": "App Key",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "app_key"
        ],
        "title": "TaskIntegrationMutationResponse",
        "type": "object"
      },
      "TaskIntegrationsResponse": {
        "description": "Response containing all task integrations",
        "properties": {
          "default_app": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Default task integration app key",
            "title": "Default App"
          },
          "integrations": {
            "additionalProperties": true,
            "description": "Map of app_key to connection details",
            "title": "Integrations",
            "type": "object"
          }
        },
        "required": [
          "integrations",
          "default_app"
        ],
        "title": "TaskIntegrationsResponse",
        "type": "object"
      },
      "TaskIntelligenceFeedbackAction": {
        "enum": [
          "do_now",
          "later",
          "dismiss",
          "accept_candidate",
          "edit",
          "complete"
        ],
        "title": "TaskIntelligenceFeedbackAction",
        "type": "string"
      },
      "TaskIntelligenceFeedbackReason": {
        "enum": [
          "already_handled",
          "not_mine",
          "not_useful"
        ],
        "title": "TaskIntelligenceFeedbackReason",
        "type": "string"
      },
      "TaskIntelligenceOutcomeCode": {
        "enum": [
          "task_completed",
          "artifact_approved",
          "artifact_delivered",
          "decision_resolved",
          "agent_output_applied",
          "workstream_advanced"
        ],
        "title": "TaskIntelligenceOutcomeCode",
        "type": "string"
      },
      "TaskOriginWorkIntent": {
        "additionalProperties": false,
        "properties": {
          "objective": {
            "anyOf": [
              {
                "maxLength": 2048,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Objective"
          },
          "origin": {
            "const": "task",
            "default": "task",
            "title": "Origin",
            "type": "string"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          },
          "title": {
            "anyOf": [
              {
                "maxLength": 256,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "required": [
          "task_id"
        ],
        "title": "TaskOriginWorkIntent",
        "type": "object"
      },
      "TaskOwner": {
        "enum": [
          "user",
          "other",
          "unknown"
        ],
        "title": "TaskOwner",
        "type": "string"
      },
      "TaskPriority": {
        "enum": [
          "high",
          "medium",
          "low"
        ],
        "title": "TaskPriority",
        "type": "string"
      },
      "TaskStatus": {
        "enum": [
          "active",
          "completed",
          "cancelled",
          "superseded"
        ],
        "title": "TaskStatus",
        "type": "string"
      },
      "TaskSupersedeCandidate": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "const": "supersede",
            "default": "supersede",
            "title": "Proposed Action",
            "type": "string"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "subject_kind": {
            "const": "task",
            "default": "task",
            "title": "Subject Kind",
            "type": "string"
          },
          "task_change": {
            "$ref": "#/components/schemas/TaskChangePayload"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "task_id",
          "task_change"
        ],
        "title": "TaskSupersedeCandidate",
        "type": "object"
      },
      "TaskUpdateCandidate": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "const": "update",
            "default": "update",
            "title": "Proposed Action",
            "type": "string"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "subject_kind": {
            "const": "task",
            "default": "task",
            "title": "Subject Kind",
            "type": "string"
          },
          "task_change": {
            "$ref": "#/components/schemas/TaskChangePayload"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          }
        },
        "required": [
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "task_id",
          "task_change"
        ],
        "title": "TaskUpdateCandidate",
        "type": "object"
      },
      "TaskWorkflowControl": {
        "additionalProperties": false,
        "description": "Per-user universal-contract migration control; defaults preserve legacy behavior.",
        "properties": {
          "account_generation": {
            "default": 0,
            "minimum": 0,
            "title": "Account Generation",
            "type": "integer"
          },
          "workflow_mode": {
            "$ref": "#/components/schemas/TaskWorkflowMode",
            "default": "off"
          }
        },
        "title": "TaskWorkflowControl",
        "type": "object"
      },
      "TaskWorkflowMode": {
        "enum": [
          "off",
          "shadow",
          "write",
          "read"
        ],
        "title": "TaskWorkflowMode",
        "type": "string"
      },
      "TestDailySummaryRequest": {
        "properties": {
          "date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Date"
          }
        },
        "title": "TestDailySummaryRequest",
        "type": "object"
      },
      "TestPromptRequest": {
        "properties": {
          "prompt": {
            "title": "Prompt",
            "type": "string"
          }
        },
        "required": [
          "prompt"
        ],
        "title": "TestPromptRequest",
        "type": "object"
      },
      "TesterAccessRequest": {
        "properties": {
          "app_id": {
            "title": "App Id",
            "type": "string"
          },
          "uid": {
            "title": "Uid",
            "type": "string"
          }
        },
        "required": [
          "uid",
          "app_id"
        ],
        "title": "TesterAccessRequest",
        "type": "object"
      },
      "TokenResponse": {
        "properties": {
          "access_token": {
            "title": "Access Token",
            "type": "string"
          },
          "identity": {
            "title": "Identity",
            "type": "string"
          },
          "ttl": {
            "title": "Ttl",
            "type": "integer"
          }
        },
        "required": [
          "access_token",
          "ttl",
          "identity"
        ],
        "title": "TokenResponse",
        "type": "object"
      },
      "TrainingDataOptInResponse": {
        "properties": {
          "opted_in": {
            "title": "Opted In",
            "type": "boolean"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          }
        },
        "required": [
          "opted_in"
        ],
        "title": "TrainingDataOptInResponse",
        "type": "object"
      },
      "TranscriptSegment": {
        "properties": {
          "end": {
            "title": "End",
            "type": "number"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "is_user": {
            "title": "Is User",
            "type": "boolean"
          },
          "person_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Person Id"
          },
          "speaker": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": "SPEAKER_00",
            "title": "Speaker"
          },
          "speaker_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Speaker Id"
          },
          "speech_profile_processed": {
            "default": true,
            "title": "Speech Profile Processed",
            "type": "boolean"
          },
          "start": {
            "title": "Start",
            "type": "number"
          },
          "stt_provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stt Provider"
          },
          "text": {
            "title": "Text",
            "type": "string"
          },
          "translations": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/Translation"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Translations"
          }
        },
        "required": [
          "text",
          "is_user",
          "start",
          "end"
        ],
        "title": "TranscriptSegment",
        "type": "object"
      },
      "TranscriptionErrorDetail": {
        "properties": {
          "error": {
            "title": "Error",
            "type": "string"
          },
          "message": {
            "title": "Message",
            "type": "string"
          },
          "outcome": {
            "$ref": "#/components/schemas/TranscriptionOutcome"
          },
          "provider": {
            "title": "Provider",
            "type": "string"
          },
          "retryable": {
            "title": "Retryable",
            "type": "boolean"
          }
        },
        "required": [
          "error",
          "outcome",
          "provider",
          "retryable",
          "message"
        ],
        "title": "TranscriptionErrorDetail",
        "type": "object"
      },
      "TranscriptionErrorResponse": {
        "properties": {
          "detail": {
            "$ref": "#/components/schemas/TranscriptionErrorDetail"
          }
        },
        "required": [
          "detail"
        ],
        "title": "TranscriptionErrorResponse",
        "type": "object"
      },
      "TranscriptionOutcome": {
        "description": "Closed, low-cardinality vocabulary for every accepted transcription.",
        "enum": [
          "success",
          "expected_silence",
          "empty_unexpected",
          "timeout",
          "upstream_error",
          "config_error",
          "invalid_input"
        ],
        "title": "TranscriptionOutcome",
        "type": "string"
      },
      "TranscriptionPreferencesResponse": {
        "properties": {
          "custom_stt_since": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Custom Stt Since"
          },
          "language": {
            "default": "",
            "title": "Language",
            "type": "string"
          },
          "single_language_mode": {
            "default": false,
            "title": "Single Language Mode",
            "type": "boolean"
          },
          "uses_custom_stt": {
            "default": false,
            "title": "Uses Custom Stt",
            "type": "boolean"
          },
          "vocabulary": {
            "items": {
              "type": "string"
            },
            "title": "Vocabulary",
            "type": "array"
          }
        },
        "title": "TranscriptionPreferencesResponse",
        "type": "object"
      },
      "TranscriptionPreferencesUpdate": {
        "properties": {
          "single_language_mode": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Single Language Mode"
          },
          "vocabulary": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Vocabulary"
          }
        },
        "title": "TranscriptionPreferencesUpdate",
        "type": "object"
      },
      "Translation": {
        "properties": {
          "lang": {
            "title": "Lang",
            "type": "string"
          },
          "text": {
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "lang",
          "text"
        ],
        "title": "Translation",
        "type": "object"
      },
      "TrialMetadata": {
        "description": "Structured trial state for desktop clients to render countdown UI.",
        "properties": {
          "plan_after_trial": {
            "default": "Free",
            "title": "Plan After Trial",
            "type": "string"
          },
          "trial_duration_seconds": {
            "default": 0,
            "title": "Trial Duration Seconds",
            "type": "integer"
          },
          "trial_ends_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Trial Ends At"
          },
          "trial_expired": {
            "default": false,
            "title": "Trial Expired",
            "type": "boolean"
          },
          "trial_features": {
            "default": [],
            "items": {
              "type": "string"
            },
            "title": "Trial Features",
            "type": "array"
          },
          "trial_remaining_seconds": {
            "default": 0,
            "title": "Trial Remaining Seconds",
            "type": "integer"
          },
          "trial_started_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Trial Started At"
          }
        },
        "title": "TrialMetadata",
        "type": "object"
      },
      "TriggerType": {
        "enum": [
          "immediate",
          "version_upgrade",
          "firmware_upgrade"
        ],
        "title": "TriggerType",
        "type": "string"
      },
      "TtsSynthesizeRequest": {
        "properties": {
          "model_id": {
            "default": "eleven_turbo_v2_5",
            "title": "Model Id",
            "type": "string"
          },
          "output_format": {
            "default": "mp3_44100_128",
            "title": "Output Format",
            "type": "string"
          },
          "text": {
            "maxLength": 5000,
            "minLength": 1,
            "title": "Text",
            "type": "string"
          },
          "voice_id": {
            "default": "BAMYoBHLZM7lJgJAmFz0",
            "title": "Voice Id",
            "type": "string"
          },
          "voice_settings": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TtsVoiceSettings"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "text"
        ],
        "title": "TtsSynthesizeRequest",
        "type": "object"
      },
      "TtsVoiceSettings": {
        "properties": {
          "similarity_boost": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Similarity Boost"
          },
          "stability": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stability"
          },
          "style": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Style"
          },
          "use_speaker_boost": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Use Speaker Boost"
          }
        },
        "title": "TtsVoiceSettings",
        "type": "object"
      },
      "UnapprovedPublicAppResponse": {
        "additionalProperties": true,
        "properties": {
          "approved": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Approved"
          },
          "author": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Author"
          },
          "capabilities": {
            "items": {
              "type": "string"
            },
            "title": "Capabilities",
            "type": "array"
          },
          "category": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Category"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "image": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "private": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Private"
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "uid": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Uid"
          }
        },
        "title": "UnapprovedPublicAppResponse",
        "type": "object"
      },
      "UpdateAIUserProfileRequest": {
        "properties": {
          "data_sources_used": {
            "anyOf": [
              {
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Sources Used"
          },
          "generated_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Generated At"
          },
          "profile_text": {
            "anyOf": [
              {
                "maxLength": 50000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Text"
          }
        },
        "title": "UpdateAIUserProfileRequest",
        "type": "object"
      },
      "UpdateActionItemDescriptionRequest": {
        "properties": {
          "description": {
            "title": "Description",
            "type": "string"
          },
          "old_description": {
            "title": "Old Description",
            "type": "string"
          }
        },
        "required": [
          "old_description",
          "description"
        ],
        "title": "UpdateActionItemDescriptionRequest",
        "type": "object"
      },
      "UpdateActionItemRequest": {
        "properties": {
          "completed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "New completion status",
            "title": "Completed"
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New description",
            "title": "Description"
          },
          "due_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New due date (ISO format with timezone)",
            "title": "Due At"
          }
        },
        "title": "UpdateActionItemRequest",
        "type": "object"
      },
      "UpdateAnnouncementRequest": {
        "description": "Request body for updating an announcement.",
        "properties": {
          "active": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Active"
          },
          "app_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Version"
          },
          "content": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content"
          },
          "device_models": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Device Models"
          },
          "display": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Display"
              },
              {
                "type": "null"
              }
            ]
          },
          "expires_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires At"
          },
          "firmware_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Firmware Version"
          },
          "targeting": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Targeting"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "UpdateAnnouncementRequest",
        "type": "object"
      },
      "UpdateAssistantSettingsRequest": {
        "properties": {
          "advice": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AdviceAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "floating_bar": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FloatingBarSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "focus": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/FocusAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "memory": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MemoryAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "shared": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SharedAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "task": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TaskAssistantSettings"
              },
              {
                "type": "null"
              }
            ]
          },
          "update_channel": {
            "anyOf": [
              {
                "maxLength": 50,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Update Channel"
          }
        },
        "title": "UpdateAssistantSettingsRequest",
        "type": "object"
      },
      "UpdateConversationRequest": {
        "properties": {
          "discarded": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "Whether the conversation is discarded",
            "title": "Discarded"
          },
          "title": {
            "anyOf": [
              {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New title for the conversation",
            "title": "Title"
          }
        },
        "title": "UpdateConversationRequest",
        "type": "object"
      },
      "UpdateFolderRequest": {
        "description": "Request model for updating folder metadata.",
        "properties": {
          "color": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Color"
          },
          "description": {
            "anyOf": [
              {
                "maxLength": 500,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Natural language instruction for AI",
            "title": "Description"
          },
          "icon": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Icon"
          },
          "name": {
            "anyOf": [
              {
                "maxLength": 100,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "order": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Order"
          }
        },
        "title": "UpdateFolderRequest",
        "type": "object"
      },
      "UpdateGoalRequest": {
        "properties": {
          "current_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "New progress value",
            "title": "Current Value"
          },
          "desired_outcome": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Desired Outcome"
          },
          "horizon_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Horizon At"
          },
          "max_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "New maximum value",
            "title": "Max Value"
          },
          "min_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "New minimum value",
            "title": "Min Value"
          },
          "success_criteria": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "maxItems": 20,
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Success Criteria"
          },
          "target_value": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "New target value",
            "title": "Target Value"
          },
          "title": {
            "anyOf": [
              {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New title",
            "title": "Title"
          },
          "unit": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New unit label",
            "title": "Unit"
          },
          "why_it_matters": {
            "anyOf": [
              {
                "maxLength": 2000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why It Matters"
          }
        },
        "title": "UpdateGoalRequest",
        "type": "object"
      },
      "UpdateMemoryRequest": {
        "properties": {
          "category": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MemoryCategory"
              },
              {
                "type": "null"
              }
            ],
            "description": "New category for the memory"
          },
          "content": {
            "anyOf": [
              {
                "maxLength": 500,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New content for the memory",
            "title": "Content"
          },
          "tags": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "description": "New tags for the memory",
            "title": "Tags"
          },
          "visibility": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "New visibility: public or private",
            "title": "Visibility"
          }
        },
        "title": "UpdateMemoryRequest",
        "type": "object"
      },
      "UpdateNotificationSettingsRequest": {
        "properties": {
          "enabled": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enabled"
          },
          "frequency": {
            "anyOf": [
              {
                "maximum": 5,
                "minimum": 0,
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Frequency"
          }
        },
        "title": "UpdateNotificationSettingsRequest",
        "type": "object"
      },
      "UpdateSegmentTextRequest": {
        "properties": {
          "segment_id": {
            "minLength": 1,
            "title": "Segment Id",
            "type": "string"
          },
          "text": {
            "maxLength": 10000,
            "minLength": 1,
            "title": "Text",
            "type": "string"
          }
        },
        "required": [
          "segment_id",
          "text"
        ],
        "title": "UpdateSegmentTextRequest",
        "type": "object"
      },
      "UpdateSummaryRequest": {
        "properties": {
          "app_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "App Id"
          },
          "content": {
            "maxLength": 10000,
            "minLength": 1,
            "title": "Content",
            "type": "string"
          }
        },
        "required": [
          "content"
        ],
        "title": "UpdateSummaryRequest",
        "type": "object"
      },
      "UpgradeSubscriptionRequest": {
        "properties": {
          "price_id": {
            "title": "Price Id",
            "type": "string"
          },
          "promotion_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Promotion Code"
          }
        },
        "required": [
          "price_id"
        ],
        "title": "UpgradeSubscriptionRequest",
        "type": "object"
      },
      "UsageHistoryPoint": {
        "properties": {
          "date": {
            "title": "Date",
            "type": "string"
          },
          "insights_gained": {
            "default": 0,
            "title": "Insights Gained",
            "type": "integer"
          },
          "memories_created": {
            "default": 0,
            "title": "Memories Created",
            "type": "integer"
          },
          "speech_seconds": {
            "default": 0,
            "title": "Speech Seconds",
            "type": "integer"
          },
          "transcription_seconds": {
            "default": 0,
            "title": "Transcription Seconds",
            "type": "integer"
          },
          "words_transcribed": {
            "default": 0,
            "title": "Words Transcribed",
            "type": "integer"
          }
        },
        "required": [
          "date"
        ],
        "title": "UsageHistoryPoint",
        "type": "object"
      },
      "UsagePeriod": {
        "enum": [
          "today",
          "monthly",
          "yearly",
          "all_time"
        ],
        "title": "UsagePeriod",
        "type": "string"
      },
      "UsageStats": {
        "description": "Represents a set of usage metrics for a period.",
        "properties": {
          "insights_gained": {
            "default": 0,
            "title": "Insights Gained",
            "type": "integer"
          },
          "memories_created": {
            "default": 0,
            "title": "Memories Created",
            "type": "integer"
          },
          "speech_seconds": {
            "default": 0,
            "title": "Speech Seconds",
            "type": "integer"
          },
          "transcription_seconds": {
            "default": 0,
            "title": "Transcription Seconds",
            "type": "integer"
          },
          "words_transcribed": {
            "default": 0,
            "title": "Words Transcribed",
            "type": "integer"
          }
        },
        "title": "UsageStats",
        "type": "object"
      },
      "UserDataExportResponse": {
        "properties": {
          "action_items": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Action Items",
            "type": "array"
          },
          "chat_messages": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Chat Messages",
            "type": "array"
          },
          "conversations": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Conversations",
            "type": "array"
          },
          "memories": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "Memories",
            "type": "array"
          },
          "people": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "title": "People",
            "type": "array"
          },
          "profile": {
            "additionalProperties": true,
            "title": "Profile",
            "type": "object"
          }
        },
        "title": "UserDataExportResponse",
        "type": "object"
      },
      "UserLanguageResponse": {
        "properties": {
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          }
        },
        "title": "UserLanguageResponse",
        "type": "object"
      },
      "UserLanguageUpdateResponse": {
        "properties": {
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "single_language_mode": {
            "title": "Single Language Mode",
            "type": "boolean"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "single_language_mode"
        ],
        "title": "UserLanguageUpdateResponse",
        "type": "object"
      },
      "UserProfile": {
        "properties": {
          "data_sources_used": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Sources Used"
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "generated_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Generated At"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "phone_number": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Phone Number"
          },
          "profile_text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Text"
          }
        },
        "title": "UserProfile",
        "type": "object"
      },
      "UserProfileResponse": {
        "additionalProperties": true,
        "properties": {
          "company": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Company"
          },
          "created_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At"
          },
          "data_protection_level": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Data Protection Level"
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email"
          },
          "job": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Job"
          },
          "migration_status": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Migration Status"
          },
          "motivation": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Motivation"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "time_zone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Time Zone"
          },
          "uid": {
            "title": "Uid",
            "type": "string"
          },
          "use_case": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Use Case"
          }
        },
        "required": [
          "uid"
        ],
        "title": "UserProfileResponse",
        "type": "object"
      },
      "UserStatusResponse": {
        "properties": {
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "status": {
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status"
        ],
        "title": "UserStatusResponse",
        "type": "object"
      },
      "UserSubscriptionResponse": {
        "properties": {
          "available_plans": {
            "default": [],
            "items": {
              "$ref": "#/components/schemas/SubscriptionPlan"
            },
            "title": "Available Plans",
            "type": "array"
          },
          "chat_quota_allowed": {
            "default": true,
            "title": "Chat Quota Allowed",
            "type": "boolean"
          },
          "chat_quota_percent": {
            "default": 0,
            "title": "Chat Quota Percent",
            "type": "number"
          },
          "chat_quota_reset_at": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Chat Quota Reset At"
          },
          "chat_quota_unit": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ChatQuotaUnit"
              },
              {
                "type": "null"
              }
            ]
          },
          "chat_quota_used": {
            "default": 0,
            "title": "Chat Quota Used",
            "type": "number"
          },
          "desktop_grandfather_until": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Desktop Grandfather Until"
          },
          "insights_gained_limit": {
            "title": "Insights Gained Limit",
            "type": "integer"
          },
          "insights_gained_used": {
            "title": "Insights Gained Used",
            "type": "integer"
          },
          "phone_call_quota": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhoneCallQuota"
              },
              {
                "type": "null"
              }
            ]
          },
          "show_subscription_ui": {
            "default": true,
            "title": "Show Subscription Ui",
            "type": "boolean"
          },
          "subscription": {
            "$ref": "#/components/schemas/Subscription"
          },
          "transcription_seconds_limit": {
            "title": "Transcription Seconds Limit",
            "type": "integer"
          },
          "transcription_seconds_used": {
            "title": "Transcription Seconds Used",
            "type": "integer"
          },
          "words_transcribed_limit": {
            "title": "Words Transcribed Limit",
            "type": "integer"
          },
          "words_transcribed_used": {
            "title": "Words Transcribed Used",
            "type": "integer"
          }
        },
        "required": [
          "subscription",
          "transcription_seconds_used",
          "transcription_seconds_limit",
          "words_transcribed_used",
          "words_transcribed_limit",
          "insights_gained_used",
          "insights_gained_limit"
        ],
        "title": "UserSubscriptionResponse",
        "type": "object"
      },
      "UserUsageResponse": {
        "description": "The response model for the user usage API endpoint.",
        "properties": {
          "all_time": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UsageStats"
              },
              {
                "type": "null"
              }
            ]
          },
          "history": {
            "anyOf": [
              {
                "items": {
                  "$ref": "#/components/schemas/UsageHistoryPoint"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "History"
          },
          "monthly": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UsageStats"
              },
              {
                "type": "null"
              }
            ]
          },
          "today": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UsageStats"
              },
              {
                "type": "null"
              }
            ]
          },
          "yearly": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/UsageStats"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "title": "UserUsageResponse",
        "type": "object"
      },
      "UserWebhookUrlResponse": {
        "properties": {
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          }
        },
        "title": "UserWebhookUrlResponse",
        "type": "object"
      },
      "UserWebhooksStatusResponse": {
        "properties": {
          "audio_bytes": {
            "title": "Audio Bytes",
            "type": "boolean"
          },
          "day_summary": {
            "title": "Day Summary",
            "type": "boolean"
          },
          "memory_created": {
            "title": "Memory Created",
            "type": "boolean"
          },
          "realtime_transcript": {
            "title": "Realtime Transcript",
            "type": "boolean"
          }
        },
        "required": [
          "audio_bytes",
          "memory_created",
          "realtime_transcript",
          "day_summary"
        ],
        "title": "UserWebhooksStatusResponse",
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "loc": {
            "items": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "integer"
                }
              ]
            },
            "title": "Location",
            "type": "array"
          },
          "msg": {
            "title": "Message",
            "type": "string"
          },
          "type": {
            "title": "Error Type",
            "type": "string"
          }
        },
        "required": [
          "loc",
          "msg",
          "type"
        ],
        "title": "ValidationError",
        "type": "object"
      },
      "VerifyPhoneNumberRequest": {
        "properties": {
          "phone_number": {
            "description": "Phone number in E.164 format (e.g., +15551234567)",
            "title": "Phone Number",
            "type": "string"
          }
        },
        "required": [
          "phone_number"
        ],
        "title": "VerifyPhoneNumberRequest",
        "type": "object"
      },
      "VerifyPhoneNumberResponse": {
        "properties": {
          "phone_number": {
            "title": "Phone Number",
            "type": "string"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "validation_code": {
            "title": "Validation Code",
            "type": "string"
          },
          "verification_sid": {
            "title": "Verification Sid",
            "type": "string"
          }
        },
        "required": [
          "verification_sid",
          "phone_number",
          "validation_code",
          "status"
        ],
        "title": "VerifyPhoneNumberResponse",
        "type": "object"
      },
      "VoiceMessageTranscriptionResponse": {
        "properties": {
          "language": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Language"
          },
          "outcome": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TranscriptionOutcome"
              },
              {
                "type": "null"
              }
            ]
          },
          "stt_model": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stt Model"
          },
          "stt_provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Stt Provider"
          },
          "transcript": {
            "title": "Transcript",
            "type": "string"
          }
        },
        "required": [
          "transcript"
        ],
        "title": "VoiceMessageTranscriptionResponse",
        "type": "object"
      },
      "WebhookType": {
        "enum": [
          "audio_bytes",
          "audio_bytes_websocket",
          "realtime_transcript",
          "memory_created",
          "day_summary"
        ],
        "title": "WebhookType",
        "type": "string"
      },
      "WhatMattersNowProjection": {
        "additionalProperties": false,
        "properties": {
          "evaluation_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Evaluation Id",
            "type": "string"
          },
          "expires_at": {
            "format": "date-time",
            "title": "Expires At",
            "type": "string"
          },
          "generated_at": {
            "format": "date-time",
            "title": "Generated At",
            "type": "string"
          },
          "material_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Material Version",
            "type": "string"
          },
          "output_version": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Output Version",
            "type": "string"
          },
          "recommendations": {
            "items": {
              "$ref": "#/components/schemas/Recommendation"
            },
            "maxItems": 3,
            "title": "Recommendations",
            "type": "array"
          },
          "schema_version": {
            "const": 1,
            "default": 1,
            "title": "Schema Version",
            "type": "integer"
          }
        },
        "required": [
          "evaluation_id",
          "output_version",
          "material_version",
          "generated_at",
          "expires_at",
          "recommendations"
        ],
        "title": "WhatMattersNowProjection",
        "type": "object"
      },
      "WorkIntentReceipt": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "newly_created": {
            "title": "Newly Created",
            "type": "boolean"
          },
          "receipt_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Receipt Id",
            "type": "string"
          },
          "task_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Task Id",
            "type": "string"
          },
          "workstream_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Workstream Id",
            "type": "string"
          }
        },
        "required": [
          "receipt_id",
          "workstream_id",
          "task_id",
          "newly_created",
          "created_at"
        ],
        "title": "WorkIntentReceipt",
        "type": "object"
      },
      "Workstream": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "current_state_summary": {
            "default": "",
            "maxLength": 4000,
            "title": "Current State Summary",
            "type": "string"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "last_meaningful_progress_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Meaningful Progress At"
          },
          "latest_event_sequence": {
            "default": 0,
            "minimum": 0,
            "title": "Latest Event Sequence",
            "type": "integer"
          },
          "next_review_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Review At"
          },
          "objective": {
            "maxLength": 2048,
            "minLength": 1,
            "title": "Objective",
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/WorkstreamStatus"
          },
          "title": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          },
          "updated_at": {
            "format": "date-time",
            "title": "Updated At",
            "type": "string"
          },
          "workstream_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Workstream Id",
            "type": "string"
          }
        },
        "required": [
          "workstream_id",
          "title",
          "objective",
          "status",
          "created_at",
          "updated_at"
        ],
        "title": "Workstream",
        "type": "object"
      },
      "WorkstreamCreateCandidate": {
        "additionalProperties": false,
        "properties": {
          "capture_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Capture Confidence",
            "type": "number"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "minItems": 1,
            "title": "Evidence Refs",
            "type": "array"
          },
          "goal_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Goal Id"
          },
          "ownership_confidence": {
            "maximum": 1,
            "minimum": 0,
            "title": "Ownership Confidence",
            "type": "number"
          },
          "proposed_action": {
            "const": "create",
            "default": "create",
            "title": "Proposed Action",
            "type": "string"
          },
          "source_surface": {
            "maxLength": 64,
            "minLength": 1,
            "title": "Source Surface",
            "type": "string"
          },
          "subject_kind": {
            "const": "workstream",
            "default": "workstream",
            "title": "Subject Kind",
            "type": "string"
          },
          "workstream_id": {
            "anyOf": [
              {
                "maxLength": 128,
                "minLength": 1,
                "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Workstream Id"
          },
          "workstream_proposal": {
            "$ref": "#/components/schemas/WorkstreamProposal"
          }
        },
        "required": [
          "capture_confidence",
          "ownership_confidence",
          "evidence_refs",
          "source_surface",
          "workstream_proposal"
        ],
        "title": "WorkstreamCreateCandidate",
        "type": "object"
      },
      "WorkstreamDetailProjection": {
        "additionalProperties": false,
        "properties": {
          "artifacts": {
            "items": {
              "$ref": "#/components/schemas/ArtifactDescriptor"
            },
            "title": "Artifacts",
            "type": "array"
          },
          "checkpoints": {
            "items": {
              "$ref": "#/components/schemas/ContinuationCheckpoint"
            },
            "title": "Checkpoints",
            "type": "array"
          },
          "recent_events": {
            "items": {
              "$ref": "#/components/schemas/WorkstreamEvent"
            },
            "title": "Recent Events",
            "type": "array"
          },
          "tasks": {
            "items": {
              "$ref": "#/components/schemas/ActionItemResponse"
            },
            "title": "Tasks",
            "type": "array"
          },
          "workstream": {
            "$ref": "#/components/schemas/Workstream"
          }
        },
        "required": [
          "workstream",
          "recent_events",
          "tasks",
          "artifacts",
          "checkpoints"
        ],
        "title": "WorkstreamDetailProjection",
        "type": "object"
      },
      "WorkstreamEvent": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "event_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Event Id",
            "type": "string"
          },
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "kind": {
            "$ref": "#/components/schemas/WorkstreamEventKind"
          },
          "sensitivity": {
            "$ref": "#/components/schemas/WorkstreamSensitivity"
          },
          "sequence": {
            "minimum": 1,
            "title": "Sequence",
            "type": "integer"
          },
          "summary": {
            "maxLength": 2000,
            "minLength": 1,
            "title": "Summary",
            "type": "string"
          },
          "workstream_id": {
            "maxLength": 128,
            "minLength": 1,
            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$",
            "title": "Workstream Id",
            "type": "string"
          }
        },
        "required": [
          "event_id",
          "workstream_id",
          "sequence",
          "kind",
          "summary",
          "sensitivity",
          "created_at"
        ],
        "title": "WorkstreamEvent",
        "type": "object"
      },
      "WorkstreamEventCreate": {
        "additionalProperties": false,
        "properties": {
          "evidence_refs": {
            "items": {
              "$ref": "#/components/schemas/EvidenceRef"
            },
            "maxItems": 50,
            "title": "Evidence Refs",
            "type": "array"
          },
          "kind": {
            "$ref": "#/components/schemas/WorkstreamEventKind"
          },
          "sensitivity": {
            "$ref": "#/components/schemas/WorkstreamSensitivity",
            "default": "normal"
          },
          "summary": {
            "maxLength": 2000,
            "minLength": 1,
            "title": "Summary",
            "type": "string"
          }
        },
        "required": [
          "kind",
          "summary"
        ],
        "title": "WorkstreamEventCreate",
        "type": "object"
      },
      "WorkstreamEventKind": {
        "enum": [
          "user_note",
          "conversation",
          "message",
          "screen_observation",
          "task_change",
          "decision",
          "agent_update",
          "artifact_version",
          "external_update",
          "system"
        ],
        "title": "WorkstreamEventKind",
        "type": "string"
      },
      "WorkstreamProposal": {
        "additionalProperties": false,
        "properties": {
          "anchor_task": {
            "$ref": "#/components/schemas/TaskCreatePayload"
          },
          "objective": {
            "maxLength": 2048,
            "minLength": 1,
            "title": "Objective",
            "type": "string"
          },
          "title": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "objective",
          "anchor_task"
        ],
        "title": "WorkstreamProposal",
        "type": "object"
      },
      "WorkstreamProposal-Output": {
        "additionalProperties": false,
        "properties": {
          "anchor_task": {
            "$ref": "#/components/schemas/TaskCreatePayload"
          },
          "objective": {
            "maxLength": 2048,
            "minLength": 1,
            "title": "Objective",
            "type": "string"
          },
          "title": {
            "maxLength": 256,
            "minLength": 1,
            "title": "Title",
            "type": "string"
          }
        },
        "required": [
          "title",
          "objective",
          "anchor_task"
        ],
        "title": "WorkstreamProposal",
        "type": "object"
      },
      "WorkstreamSensitivity": {
        "enum": [
          "normal",
          "sensitive",
          "restricted"
        ],
        "title": "WorkstreamSensitivity",
        "type": "string"
      },
      "WorkstreamStatus": {
        "enum": [
          "open",
          "paused",
          "completed",
          "archived"
        ],
        "title": "WorkstreamStatus",
        "type": "string"
      },
      "WorkstreamUpdate": {
        "additionalProperties": false,
        "properties": {
          "current_state_summary": {
            "anyOf": [
              {
                "maxLength": 4000,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Current State Summary"
          },
          "next_review_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Review At"
          },
          "objective": {
            "anyOf": [
              {
                "maxLength": 2048,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Objective"
          },
          "status": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WorkstreamStatus"
              },
              {
                "type": "null"
              }
            ]
          },
          "title": {
            "anyOf": [
              {
                "maxLength": 256,
                "minLength": 1,
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          }
        },
        "title": "WorkstreamUpdate",
        "type": "object"
      },
      "WrappedStatusResponse": {
        "properties": {
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "progress": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Progress"
          },
          "result": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Result"
          },
          "status": {
            "title": "Status",
            "type": "string"
          },
          "year": {
            "default": 2025,
            "title": "Year",
            "type": "integer"
          }
        },
        "required": [
          "status"
        ],
        "title": "WrappedStatusResponse",
        "type": "object"
      },
      "routers__memories__BatchMemoriesRequest": {
        "properties": {
          "memories": {
            "description": "List of memories to create in a single batch request",
            "items": {
              "$ref": "#/components/schemas/Memory"
            },
            "maxItems": 100,
            "title": "Memories",
            "type": "array"
          }
        },
        "required": [
          "memories"
        ],
        "title": "BatchMemoriesRequest",
        "type": "object"
      },
      "routers__memories__BatchMemoriesResponse": {
        "properties": {
          "created_count": {
            "title": "Created Count",
            "type": "integer"
          },
          "memories": {
            "items": {
              "$ref": "#/components/schemas/MemoryDB"
            },
            "title": "Memories",
            "type": "array"
          }
        },
        "required": [
          "memories",
          "created_count"
        ],
        "title": "BatchMemoriesResponse",
        "type": "object"
      },
      "routers__payment__PricingOption": {
        "properties": {
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "eyebrow": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Eyebrow"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "interval": {
            "title": "Interval",
            "type": "string"
          },
          "is_active": {
            "default": false,
            "title": "Is Active",
            "type": "boolean"
          },
          "plan_id": {
            "default": "",
            "title": "Plan Id",
            "type": "string"
          },
          "price_string": {
            "title": "Price String",
            "type": "string"
          },
          "subtitle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subtitle"
          },
          "title": {
            "title": "Title",
            "type": "string"
          },
          "unit_amount": {
            "title": "Unit Amount",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "title",
          "price_string",
          "interval",
          "unit_amount"
        ],
        "title": "PricingOption",
        "type": "object"
      }
    },
    "securitySchemes": {
      "firebaseBearer": {
        "bearerFormat": "Firebase ID token",
        "description": "Send `Authorization: Bearer <firebase_id_token>`.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "contact": {
      "name": "Omi",
      "url": "https://omi.me/"
    },
    "description": "Programmatic access to your Omi data - memories, conversations, action items, goals, folders, and API keys. Build custom integrations, analytics dashboards, and automation workflows.",
    "license": {
      "name": "MIT",
      "url": "https://github.com/BasedHardware/omi/blob/main/LICENSE"
    },
    "title": "Omi App Client API",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/action-items": {
      "get": {
        "description": "Get action items for the current user.",
        "operationId": "get_action_items_v1_action_items_get",
        "parameters": [
          {
            "description": "Maximum number of action items to return",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "description": "Maximum number of action items to return",
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "description": "Number of action items to skip",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "description": "Number of action items to skip",
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "description": "Filter by completion status",
            "in": "query",
            "name": "completed",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by completion status",
              "title": "Completed"
            }
          },
          {
            "description": "Filter by conversation ID",
            "in": "query",
            "name": "conversation_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by conversation ID",
              "title": "Conversation Id"
            }
          },
          {
            "description": "Filter by creation start date (inclusive)",
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by creation start date (inclusive)",
              "title": "Start Date"
            }
          },
          {
            "description": "Filter by creation end date (inclusive)",
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by creation end date (inclusive)",
              "title": "End Date"
            }
          },
          {
            "description": "Filter by due start date (inclusive)",
            "in": "query",
            "name": "due_start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by due start date (inclusive)",
              "title": "Due Start Date"
            }
          },
          {
            "description": "Filter by due end date (inclusive)",
            "in": "query",
            "name": "due_end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by due end date (inclusive)",
              "title": "Due End Date"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Action Items",
        "tags": [
          "action-items"
        ]
      },
      "post": {
        "description": "Create a new action item.\n\nContent-idempotent on (uid, normalized description): a retry of the same\nrequest returns the original action_item rather than creating a duplicate.",
        "operationId": "create_action_item_v1_action_items_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ActionItemCreateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Action Item",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/accept": {
      "post": {
        "description": "Save shared tasks to the recipient's task list.",
        "operationId": "accept_shared_action_items_v1_action_items_accept_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AcceptSharedTasksRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AcceptSharedActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Accept Shared Action Items",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/batch": {
      "patch": {
        "description": "Batch update sort_order and indent_level for multiple action items.",
        "operationId": "batch_update_action_items_v1_action_items_batch_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchUpdateActionItemsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Batch Update Action Items",
        "tags": [
          "action-items"
        ]
      },
      "post": {
        "description": "Create multiple action items in a batch.",
        "operationId": "create_action_items_batch_v1_action_items_batch_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "items": {
                  "$ref": "#/components/schemas/ActionItemCreateRequest"
                },
                "title": "Action Items",
                "type": "array"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchCreateActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Action Items Batch",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/batch-delete": {
      "post": {
        "description": "Delete multiple action items in one request.\n\nFirestore deletes go through chunked batched commits in the DB layer; the\nvector store delete and the FCM cancellation message both use their batch\nhelpers — no per-id loop on this hot path.",
        "operationId": "batch_delete_action_items_v1_action_items_batch_delete_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchDeleteActionItemsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchDeleteActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Batch Delete Action Items",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/ids": {
      "get": {
        "description": "Return all of the user's action-item IDs (IDs only, no field reads).\n\nA lightweight way for a client to reconcile which tasks it has without paging the full\nlist. Declared before /v1/action-items/{action_item_id} so the static path is not\ncaptured as an action item id.",
        "operationId": "list_action_item_ids_v1_action_items_ids_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemIdsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Action Item Ids",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/pending-sync": {
      "get": {
        "description": "Get action items that need sync: pending export + already synced items for bidirectional sync.",
        "operationId": "get_pending_sync_items_v1_action_items_pending_sync_get",
        "parameters": [
          {
            "description": "Sync platform",
            "in": "query",
            "name": "platform",
            "required": false,
            "schema": {
              "default": "apple_reminders",
              "description": "Sync platform",
              "title": "Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PendingSyncResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Pending Sync Items",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/search": {
      "get": {
        "description": "Semantic search across action items using vector similarity.",
        "operationId": "search_action_items_v1_action_items_search_get",
        "parameters": [
          {
            "description": "Search query",
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "description": "Search query",
              "minLength": 1,
              "title": "Query",
              "type": "string"
            }
          },
          {
            "description": "Maximum results",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "description": "Maximum results",
              "maximum": 50,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemsSearchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Action Items",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/share": {
      "post": {
        "description": "Create a shareable link for selected action items.",
        "operationId": "share_action_items_v1_action_items_share_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ShareTasksRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShareActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Share Action Items",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/shared/{token}": {
      "get": {
        "description": "Public endpoint — get shared task preview (no auth required).",
        "operationId": "get_shared_action_items_v1_action_items_shared__token__get",
        "parameters": [
          {
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "title": "Token",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Get Shared Action Items",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/sync-batch": {
      "patch": {
        "description": "Batch update action items during reminders sync. Single Firestore batch commit.",
        "operationId": "sync_batch_update_v1_action_items_sync_batch_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SyncBatchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Sync Batch Update",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/{action_item_id}": {
      "delete": {
        "description": "Delete an action item.",
        "operationId": "delete_action_item_v1_action_items__action_item_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Action Item",
        "tags": [
          "action-items"
        ]
      },
      "get": {
        "description": "Get a specific action item by ID.",
        "operationId": "get_action_item_v1_action_items__action_item_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Action Item",
        "tags": [
          "action-items"
        ]
      },
      "patch": {
        "description": "Update an action item.",
        "operationId": "update_action_item_v1_action_items__action_item_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ActionItemUpdateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Action Item",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/action-items/{action_item_id}/completed": {
      "patch": {
        "description": "Mark an action item as completed or uncompleted.",
        "operationId": "toggle_action_item_completion_v1_action_items__action_item_id__completed_patch",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          },
          {
            "description": "Whether to mark as completed or not",
            "in": "query",
            "name": "completed",
            "required": true,
            "schema": {
              "description": "Whether to mark as completed or not",
              "title": "Completed",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionItemResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Toggle Action Item Completion",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/agent/execute-tool": {
      "post": {
        "description": "Execute a named tool and return its result.",
        "operationId": "execute_tool_v1_agent_execute_tool_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExecuteToolRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExecuteToolResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Execute Tool"
      }
    },
    "/v1/agent/keepalive": {
      "post": {
        "description": "Ping the VM's /ping endpoint to reset its idle auto-stop timer.",
        "operationId": "keepalive_v1_agent_keepalive_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentKeepaliveResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Keepalive"
      }
    },
    "/v1/agent/tools": {
      "get": {
        "description": "Return all available tool definitions for a user.",
        "operationId": "list_tools_v1_agent_tools_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentToolsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Tools"
      }
    },
    "/v1/agent/vm-ensure": {
      "post": {
        "description": "Check VM status; if stopped/terminated, restart it in the background.",
        "operationId": "ensure_vm_v1_agent_vm_ensure_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentVmInfo"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Ensure Vm"
      }
    },
    "/v1/agent/vm-status": {
      "get": {
        "description": "Return the user's agent VM info from Firestore.",
        "operationId": "get_vm_status_v1_agent_vm_status_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentVmInfo"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Vm Status"
      }
    },
    "/v1/announcements": {
      "post": {
        "description": "Create a new announcement.\nRequires admin authentication via secret-key header.\n\nContent structure depends on type:\n- changelog: {\"title\": \"...\", \"changes\": [{\"title\": \"...\", \"description\": \"...\", \"icon\": \"🔀\"}, ...]}\n- feature: {\"title\": \"...\", \"steps\": [{\"title\": \"...\", \"description\": \"...\", \"image_url\": \"...\", \"highlight_text\": \"...\"}, ...]}\n- announcement: {\"title\": \"...\", \"body\": \"...\", \"image_url\": \"...\", \"cta\": {\"text\": \"...\", \"action\": \"...\"}}",
        "operationId": "create_announcement_endpoint_v1_announcements_post",
        "parameters": [
          {
            "description": "Admin secret key",
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "description": "Admin secret key",
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAnnouncementRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Announcement"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Announcement Endpoint",
        "tags": [
          "admin"
        ]
      }
    },
    "/v1/announcements/all": {
      "get": {
        "description": "List all announcements with optional filtering.\nRequires admin authentication via secret-key header.\n\nUseful for admin dashboard to see all announcements.",
        "operationId": "list_all_announcements_v1_announcements_all_get",
        "parameters": [
          {
            "description": "Filter by type",
            "in": "query",
            "name": "announcement_type",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/AnnouncementType"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by type",
              "title": "Announcement Type"
            }
          },
          {
            "description": "Only return active announcements",
            "in": "query",
            "name": "active_only",
            "required": false,
            "schema": {
              "default": false,
              "description": "Only return active announcements",
              "title": "Active Only",
              "type": "boolean"
            }
          },
          {
            "description": "Admin secret key",
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "description": "Admin secret key",
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Announcement"
                  },
                  "title": "Response List All Announcements V1 Announcements All Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List All Announcements",
        "tags": [
          "admin"
        ]
      }
    },
    "/v1/announcements/changelogs": {
      "get": {
        "description": "Get app changelog announcements.\n\nIf from_version and to_version are provided:\n    Returns changelogs where from_version < app_version <= to_version.\n\nIf max_version is provided (without from/to):\n    Returns the most recent `limit` changelogs where app_version <= max_version.\n\nIf none provided:\n    Returns the most recent `limit` changelogs.\n\nSorted by version descending (newest first).\nUser sees the latest version's changelog first, can swipe to see older versions.",
        "operationId": "get_changelogs_v1_announcements_changelogs_get",
        "parameters": [
          {
            "description": "Previous app version (before upgrade)",
            "in": "query",
            "name": "from_version",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Previous app version (before upgrade)",
              "title": "From Version"
            }
          },
          {
            "description": "Current app version (after upgrade)",
            "in": "query",
            "name": "to_version",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Current app version (after upgrade)",
              "title": "To Version"
            }
          },
          {
            "description": "Maximum version to include (filters out future versions)",
            "in": "query",
            "name": "max_version",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Maximum version to include (filters out future versions)",
              "title": "Max Version"
            }
          },
          {
            "description": "Maximum number of changelogs to return",
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 5,
              "description": "Maximum number of changelogs to return",
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Announcement"
                  },
                  "title": "Response Get Changelogs V1 Announcements Changelogs Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Changelogs"
      }
    },
    "/v1/announcements/features": {
      "get": {
        "description": "Get feature announcements for a specific version.\n\nFor firmware updates: returns features explaining new device behavior.\nFor app updates: returns features explaining major new app functionality.",
        "operationId": "get_features_v1_announcements_features_get",
        "parameters": [
          {
            "description": "Version user upgraded to",
            "in": "query",
            "name": "version",
            "required": true,
            "schema": {
              "description": "Version user upgraded to",
              "title": "Version",
              "type": "string"
            }
          },
          {
            "description": "Type: 'app' or 'firmware'",
            "in": "query",
            "name": "version_type",
            "required": true,
            "schema": {
              "description": "Type: 'app' or 'firmware'",
              "title": "Version Type",
              "type": "string"
            }
          },
          {
            "description": "Device model (for firmware features)",
            "in": "query",
            "name": "device_model",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Device model (for firmware features)",
              "title": "Device Model"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Announcement"
                  },
                  "title": "Response Get Features V1 Announcements Features Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Features"
      }
    },
    "/v1/announcements/general": {
      "get": {
        "description": "Get active, non-expired general announcements.\nIf last_checked_at is provided, only returns announcements created after that time.\n\nThese are time-based announcements (promotions, notices) not tied to versions.",
        "operationId": "get_announcements_v1_announcements_general_get",
        "parameters": [
          {
            "description": "ISO timestamp of last check (only returns newer announcements)",
            "in": "query",
            "name": "last_checked_at",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "ISO timestamp of last check (only returns newer announcements)",
              "title": "Last Checked At"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Announcement"
                  },
                  "title": "Response Get Announcements V1 Announcements General Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Announcements"
      }
    },
    "/v1/announcements/pending": {
      "get": {
        "description": "Get all pending announcements for a user.\n\nThis is the new unified endpoint that replaces the separate changelogs/features/general endpoints.\nIt supports flexible targeting and per-user dismissal tracking.\n\nFiltering logic:\n1. active == True\n2. Not in user's dismissed_announcements (if show_once == True)\n3. Within time window (start_at <= now <= expires_at)\n4. Matches targeting rules (version range, device, platform)\n5. Matches trigger type\n6. Sorted by priority (descending)\n\nTriggers:\n- app_launch: Check every app launch (for immediate announcements)\n- version_upgrade: Check only when app version changed\n- firmware_upgrade: Check only when firmware version changed",
        "operationId": "get_pending_announcements_endpoint_v1_announcements_pending_get",
        "parameters": [
          {
            "description": "Current app version (e.g., '1.0.522+240')",
            "in": "query",
            "name": "app_version",
            "required": true,
            "schema": {
              "description": "Current app version (e.g., '1.0.522+240')",
              "title": "App Version",
              "type": "string"
            }
          },
          {
            "description": "Platform: 'ios' or 'android'",
            "in": "query",
            "name": "platform",
            "required": true,
            "schema": {
              "description": "Platform: 'ios' or 'android'",
              "title": "Platform",
              "type": "string"
            }
          },
          {
            "description": "Trigger: 'app_launch', 'version_upgrade', or 'firmware_upgrade'",
            "in": "query",
            "name": "trigger",
            "required": true,
            "schema": {
              "description": "Trigger: 'app_launch', 'version_upgrade', or 'firmware_upgrade'",
              "title": "Trigger",
              "type": "string"
            }
          },
          {
            "description": "Current firmware version (optional)",
            "in": "query",
            "name": "firmware_version",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Current firmware version (optional)",
              "title": "Firmware Version"
            }
          },
          {
            "description": "Device model name (optional)",
            "in": "query",
            "name": "device_model",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Device model name (optional)",
              "title": "Device Model"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Announcement"
                  },
                  "title": "Response Get Pending Announcements Endpoint V1 Announcements Pending Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Pending Announcements Endpoint",
        "tags": [
          "announcements"
        ]
      }
    },
    "/v1/announcements/{announcement_id}": {
      "delete": {
        "description": "Delete an announcement.\nRequires admin authentication via secret-key header.\n\nBy default, performs a soft delete (sets active=false).\nSet soft_delete=false to permanently remove the announcement.",
        "operationId": "delete_announcement_endpoint_v1_announcements__announcement_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "announcement_id",
            "required": true,
            "schema": {
              "title": "Announcement Id",
              "type": "string"
            }
          },
          {
            "description": "If true, deactivates instead of permanently deleting",
            "in": "query",
            "name": "soft_delete",
            "required": false,
            "schema": {
              "default": true,
              "description": "If true, deactivates instead of permanently deleting",
              "title": "Soft Delete",
              "type": "boolean"
            }
          },
          {
            "description": "Admin secret key",
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "description": "Admin secret key",
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AnnouncementDeleteResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Announcement Endpoint",
        "tags": [
          "admin"
        ]
      },
      "get": {
        "description": "Get a single announcement by ID.\nRequires admin authentication via secret-key header.",
        "operationId": "get_announcement_v1_announcements__announcement_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "announcement_id",
            "required": true,
            "schema": {
              "title": "Announcement Id",
              "type": "string"
            }
          },
          {
            "description": "Admin secret key",
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "description": "Admin secret key",
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Announcement"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Announcement",
        "tags": [
          "admin"
        ]
      },
      "put": {
        "description": "Update an existing announcement.\nRequires admin authentication via secret-key header.\nOnly provided fields will be updated.",
        "operationId": "update_announcement_endpoint_v1_announcements__announcement_id__put",
        "parameters": [
          {
            "in": "path",
            "name": "announcement_id",
            "required": true,
            "schema": {
              "title": "Announcement Id",
              "type": "string"
            }
          },
          {
            "description": "Admin secret key",
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "description": "Admin secret key",
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAnnouncementRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Announcement"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Announcement Endpoint",
        "tags": [
          "admin"
        ]
      }
    },
    "/v1/announcements/{announcement_id}/dismiss": {
      "post": {
        "description": "Mark an announcement as dismissed for the current user.\n\nThis prevents the announcement from being shown again if show_once is True.\nThe cta_clicked field can be used to track whether the user engaged with the call-to-action.",
        "operationId": "dismiss_announcement_endpoint_v1_announcements__announcement_id__dismiss_post",
        "parameters": [
          {
            "in": "path",
            "name": "announcement_id",
            "required": true,
            "schema": {
              "title": "Announcement Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DismissAnnouncementRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DismissAnnouncementResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Dismiss Announcement Endpoint",
        "tags": [
          "announcements"
        ]
      }
    },
    "/v1/app-capabilities": {
      "get": {
        "operationId": "get_app_capabilities_v1_app_capabilities_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppCapabilityResponse"
                  },
                  "title": "Response Get App Capabilities V1 App Capabilities Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get App Capabilities",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app-categories": {
      "get": {
        "operationId": "get_app_categories_v1_app_categories_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppSelectOption"
                  },
                  "title": "Response Get App Categories V1 App Categories Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get App Categories",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/generate": {
      "post": {
        "description": "Generate an app configuration from a natural language prompt.\nThis is an experimental feature that uses AI to create app configurations.",
        "operationId": "generate_app_endpoint_v1_app_generate_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateAppRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppGenerationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Generate App Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/generate-description": {
      "post": {
        "operationId": "generate_description_endpoint_v1_app_generate_description_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateDescriptionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppDescriptionGenerationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Generate Description Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/generate-description-emoji": {
      "post": {
        "description": "Generate an app description and representative emoji.\nUsed by the quick template creator feature.",
        "operationId": "generate_description_and_emoji_endpoint_v1_app_generate_description_emoji_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateDescriptionEmojiRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppDescriptionEmojiGenerationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Generate Description And Emoji Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/generate-icon": {
      "post": {
        "description": "Generate an app icon using AI (DALL-E).\nReturns the icon as a base64 encoded PNG image.",
        "operationId": "generate_app_icon_endpoint_v1_app_generate_icon_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateAppIconRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppIconGenerationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Generate App Icon Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/generate-prompts": {
      "get": {
        "description": "Generate sample app prompts for the AI app generator.\nUses a fast model to generate creative suggestions.",
        "operationId": "generate_sample_prompts_endpoint_v1_app_generate_prompts_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppPromptsGenerationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Generate Sample Prompts Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/payment-plans": {
      "get": {
        "operationId": "get_payment_plans_v1_v1_app_payment_plans_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppSelectOption"
                  },
                  "title": "Response Get Payment Plans V1 V1 App Payment Plans Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Payment Plans V1",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/plans": {
      "get": {
        "operationId": "get_payment_plans_v1_app_plans_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppSelectOption"
                  },
                  "title": "Response Get Payment Plans V1 App Plans Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Payment Plans",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/proactive-notification-scopes": {
      "get": {
        "operationId": "get_notification_scopes_v1_app_proactive_notification_scopes_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppSelectOption"
                  },
                  "title": "Response Get Notification Scopes V1 App Proactive Notification Scopes Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Notification Scopes",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/app/thumbnails": {
      "post": {
        "description": "Upload a thumbnail image for an app.\n\nArgs:\n    file: The thumbnail image file\n    app_id: ID of the app to add thumbnail for\n    uid: User ID from auth\n\nReturns:\n    Dict with thumbnail URL",
        "operationId": "upload_app_thumbnail_endpoint_v1_app_thumbnails_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_app_thumbnail_endpoint_v1_app_thumbnails_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppThumbnailUploadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Upload App Thumbnail Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps": {
      "get": {
        "operationId": "get_apps_v1_apps_get",
        "parameters": [
          {
            "in": "query",
            "name": "include_reviews",
            "required": false,
            "schema": {
              "default": true,
              "title": "Include Reviews",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppBaseModel"
                  },
                  "title": "Response Get Apps V1 Apps Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Apps",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "create_app_v1_apps_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_create_app_v1_apps_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppCreateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create App",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/disable": {
      "post": {
        "operationId": "disable_app_endpoint_v1_apps_disable_post",
        "parameters": [
          {
            "in": "query",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Disable App Endpoint"
      }
    },
    "/v1/apps/enable": {
      "post": {
        "operationId": "enable_app_endpoint_v1_apps_enable_post",
        "parameters": [
          {
            "in": "query",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Enable App Endpoint"
      }
    },
    "/v1/apps/enabled": {
      "get": {
        "description": "Returns the list of app IDs the user has enabled/installed.",
        "operationId": "get_user_enabled_apps_v1_apps_enabled_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "type": "string"
                  },
                  "title": "Response Get User Enabled Apps V1 Apps Enabled Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Enabled Apps",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/mcp": {
      "post": {
        "description": "Add a remote MCP server as a private app with chat tools.\n\n1. Extracts domain from URL and fetches logo via Brandfetch / logo.dev\n2. Checks for OAuth metadata at /.well-known/oauth-authorization-server\n3. If OAuth required: registers client, returns auth URL for the user\n4. If no OAuth: discovers tools directly, creates app immediately",
        "operationId": "add_mcp_server_v1_apps_mcp_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/McpServerRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpAddServerResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Add Mcp Server",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/mcp/callback": {
      "get": {
        "description": "OAuth callback for MCP server authorization.\n\nExchanges the authorization code for tokens, discovers tools, updates the app.\nReturns an HTML success/failure page.",
        "operationId": "mcp_oauth_callback_v1_apps_mcp_callback_get",
        "parameters": [
          {
            "in": "query",
            "name": "code",
            "required": true,
            "schema": {
              "title": "Code",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "state",
            "required": true,
            "schema": {
              "title": "State",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Mcp Oauth Callback",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/migrate-owner": {
      "post": {
        "operationId": "migrate_app_owner_v1_apps_migrate_owner_post",
        "parameters": [
          {
            "in": "query",
            "name": "old_id",
            "required": true,
            "schema": {
              "title": "Old Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMigrationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Migrate App Owner",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/popular": {
      "get": {
        "operationId": "get_popular_apps_endpoint_v1_apps_popular_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppBaseModel"
                  },
                  "title": "Response Get Popular Apps Endpoint V1 Apps Popular Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Popular Apps Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/public/unapproved": {
      "get": {
        "operationId": "get_unapproved_public_apps_v1_apps_public_unapproved_get",
        "parameters": [
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/UnapprovedPublicAppResponse"
                  },
                  "title": "Response Get Unapproved Public Apps V1 Apps Public Unapproved Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Unapproved Public Apps",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/review": {
      "post": {
        "operationId": "review_app_v1_apps_review_post",
        "parameters": [
          {
            "in": "query",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviewAppRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Review App",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/tester": {
      "post": {
        "operationId": "add_new_tester_v1_apps_tester_post",
        "parameters": [
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddTesterRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Add New Tester",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/tester/access": {
      "delete": {
        "operationId": "remove_app_access_tester_v1_apps_tester_access_delete",
        "parameters": [
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TesterAccessRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Remove App Access Tester",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "add_app_access_tester_v1_apps_tester_access_post",
        "parameters": [
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TesterAccessRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Add App Access Tester",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/tester/check": {
      "get": {
        "operationId": "check_is_tester_v1_apps_tester_check_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppTesterCheckResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Check Is Tester",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}": {
      "delete": {
        "operationId": "delete_app_v1_apps__app_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete App",
        "tags": [
          "v1"
        ]
      },
      "get": {
        "operationId": "get_app_details_v1_apps__app_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/App"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get App Details",
        "tags": [
          "v1"
        ]
      },
      "patch": {
        "operationId": "update_app_v1_apps__app_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_update_app_v1_apps__app_id__patch"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update App",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/approve": {
      "post": {
        "operationId": "approve_app_v1_apps__app_id__approve_post",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "uid",
            "required": true,
            "schema": {
              "title": "Uid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Approve App",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/change-visibility": {
      "patch": {
        "operationId": "change_app_visibility_v1_apps__app_id__change_visibility_patch",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "private",
            "required": true,
            "schema": {
              "title": "Private",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Change App Visibility",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/keys": {
      "get": {
        "operationId": "list_api_keys_v1_apps__app_id__keys_get",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppApiKeyResponse"
                  },
                  "title": "Response List Api Keys V1 Apps  App Id  Keys Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Api Keys",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "create_api_key_for_app_v1_apps__app_id__keys_post",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppApiKeyResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Api Key For App",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/keys/{key_id}": {
      "delete": {
        "operationId": "delete_api_key_v1_apps__app_id__keys__key_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "key_id",
            "required": true,
            "schema": {
              "title": "Key Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppStatusMessageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Api Key",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/mcp/refresh": {
      "post": {
        "description": "Re-discover tools from an MCP server and update the app.",
        "operationId": "refresh_mcp_tools_v1_apps__app_id__mcp_refresh_post",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpRefreshToolsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Refresh Mcp Tools",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/popular": {
      "patch": {
        "operationId": "set_app_popular_v1_apps__app_id__popular_patch",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set App Popular",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/refresh-manifest": {
      "post": {
        "description": "Refresh chat tools manifest for an app.\n\nForces a fresh fetch of the manifest from the external URL, bypassing cache.\nOnly the app owner can refresh their app's manifest.",
        "operationId": "refresh_app_manifest_v1_apps__app_id__refresh_manifest_post",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppManifestRefreshResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Refresh App Manifest",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/reject": {
      "post": {
        "operationId": "reject_app_v1_apps__app_id__reject_post",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "uid",
            "required": true,
            "schema": {
              "title": "Uid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "secret-key",
            "required": true,
            "schema": {
              "title": "Secret-Key",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Reject App",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/review": {
      "patch": {
        "operationId": "update_app_review_v1_apps__app_id__review_patch",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviewAppRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update App Review",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/review/reply": {
      "patch": {
        "operationId": "reply_to_review_v1_apps__app_id__review_reply_patch",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReplyToReviewRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Reply To Review",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/reviews": {
      "get": {
        "operationId": "app_reviews_v1_apps__app_id__reviews_get",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/AppReview"
                  },
                  "title": "Response App Reviews V1 Apps  App Id  Reviews Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "App Reviews",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/apps/{app_id}/subscription": {
      "delete": {
        "description": "Cancel user's subscription for a specific app",
        "operationId": "cancel_app_subscription_v1_apps__app_id__subscription_delete",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppSubscriptionCancelResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Cancel App Subscription"
      },
      "get": {
        "description": "Get user's subscription for a specific app",
        "operationId": "get_app_subscription_v1_apps__app_id__subscription_get",
        "parameters": [
          {
            "in": "path",
            "name": "app_id",
            "required": true,
            "schema": {
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppSubscriptionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get App Subscription"
      }
    },
    "/v1/calendar/google/events": {
      "get": {
        "description": "List Google Calendar events within a time range.\n\nUsed by the event picker UI when manually linking a conversation to a calendar event.",
        "operationId": "list_google_calendar_events_v1_calendar_google_events_get",
        "parameters": [
          {
            "description": "Minimum time for events (ISO format)",
            "in": "query",
            "name": "time_min",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Minimum time for events (ISO format)",
              "title": "Time Min"
            }
          },
          {
            "description": "Maximum time for events (ISO format)",
            "in": "query",
            "name": "time_max",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Maximum time for events (ISO format)",
              "title": "Time Max"
            }
          },
          {
            "description": "Search query to filter events",
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Search query to filter events",
              "title": "Q"
            }
          },
          {
            "description": "Maximum number of events to return",
            "in": "query",
            "name": "max_results",
            "required": false,
            "schema": {
              "default": 20,
              "description": "Maximum number of events to return",
              "maximum": 100,
              "minimum": 1,
              "title": "Max Results",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Build",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-App-Build"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/GoogleCalendarEvent"
                  },
                  "title": "Response List Google Calendar Events V1 Calendar Google Events Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Google Calendar Events",
        "tags": [
          "google_calendar"
        ]
      }
    },
    "/v1/calendar/meetings": {
      "get": {
        "description": "List calendar meetings within a date range",
        "operationId": "list_calendar_meetings_v1_calendar_meetings_get",
        "parameters": [
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/CalendarMeetingContext"
                  },
                  "title": "Response List Calendar Meetings V1 Calendar Meetings Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Calendar Meetings",
        "tags": [
          "calendar"
        ]
      },
      "post": {
        "description": "Store or update a calendar meeting in Firestore.\nIf a meeting with the same calendar_event_id and calendar_source exists, it will be updated.",
        "operationId": "store_calendar_meeting_v1_calendar_meetings_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StoreMeetingRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreMeetingResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Store Calendar Meeting",
        "tags": [
          "calendar"
        ]
      }
    },
    "/v1/calendar/meetings/{meeting_id}": {
      "get": {
        "description": "Get a calendar meeting by its Firestore document ID",
        "operationId": "get_calendar_meeting_v1_calendar_meetings__meeting_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "meeting_id",
            "required": true,
            "schema": {
              "title": "Meeting Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarMeetingContext"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Calendar Meeting",
        "tags": [
          "calendar"
        ]
      }
    },
    "/v1/calendar/onboarding/reset": {
      "post": {
        "description": "Clear the skipped / reauth flags so the connect-calendar prompt is shown again.",
        "operationId": "reset_calendar_onboarding_v1_calendar_onboarding_reset_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarOnboardingResetResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Reset Calendar Onboarding",
        "tags": [
          "calendar_onboarding"
        ]
      }
    },
    "/v1/calendar/onboarding/skip": {
      "post": {
        "description": "Mark calendar onboarding as skipped so the prompt is not shown again.",
        "operationId": "skip_calendar_onboarding_v1_calendar_onboarding_skip_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarOnboardingSkipResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Skip Calendar Onboarding",
        "tags": [
          "calendar_onboarding"
        ]
      }
    },
    "/v1/calendar/onboarding/status": {
      "get": {
        "description": "Return the calendar onboarding state, including whether a previously-connected calendar now\nneeds reconnecting (its OAuth token expired).",
        "operationId": "get_calendar_onboarding_status_v1_calendar_onboarding_status_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarOnboardingStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Calendar Onboarding Status",
        "tags": [
          "calendar_onboarding"
        ]
      }
    },
    "/v1/candidates": {
      "get": {
        "operationId": "list_candidates_v1_candidates_get",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/CandidateStatus"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "surface",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "const": "suggested",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Surface"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateListResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Candidates",
        "tags": [
          "candidates"
        ]
      },
      "post": {
        "operationId": "create_candidate_v1_candidates_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 512,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CandidateCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateRecord"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Candidate",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/control": {
      "get": {
        "operationId": "get_candidate_workflow_control_v1_candidates_control_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskWorkflowControl"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Candidate Workflow Control",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/integrations/drain": {
      "post": {
        "operationId": "drain_candidate_integrations_v1_candidates_integrations_drain_post",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "type": "integer"
                  },
                  "title": "Response Drain Candidate Integrations V1 Candidates Integrations Drain Post",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Drain Candidate Integrations",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/migrate-staged": {
      "post": {
        "operationId": "migrate_staged_candidates_v1_candidates_migrate_staged_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CandidateMigrationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateMigrationReport"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Migrate Staged Candidates",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/{candidate_id}": {
      "get": {
        "operationId": "get_candidate_v1_candidates__candidate_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "candidate_id",
            "required": true,
            "schema": {
              "title": "Candidate Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateRecord"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Candidate",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/{candidate_id}/accept": {
      "post": {
        "operationId": "accept_candidate_v1_candidates__candidate_id__accept_post",
        "parameters": [
          {
            "in": "path",
            "name": "candidate_id",
            "required": true,
            "schema": {
              "title": "Candidate Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateResolutionReceipt"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Accept Candidate",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/{candidate_id}/expire": {
      "post": {
        "operationId": "expire_candidate_v1_candidates__candidate_id__expire_post",
        "parameters": [
          {
            "in": "path",
            "name": "candidate_id",
            "required": true,
            "schema": {
              "title": "Candidate Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CandidateResolutionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateResolutionReceipt"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Expire Candidate",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/candidates/{candidate_id}/reject": {
      "post": {
        "operationId": "reject_candidate_v1_candidates__candidate_id__reject_post",
        "parameters": [
          {
            "in": "path",
            "name": "candidate_id",
            "required": true,
            "schema": {
              "title": "Candidate Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CandidateResolutionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CandidateResolutionReceipt"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Reject Candidate",
        "tags": [
          "candidates"
        ]
      }
    },
    "/v1/conversations": {
      "get": {
        "description": "List responses may omit detail-only fields such as transcript_segments. Clients should treat omitted transcript_segments as unknown/not loaded, not as an empty transcript.",
        "operationId": "get_conversations_v1_conversations_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 1000,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "statuses",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "processing,completed",
              "title": "Statuses"
            }
          },
          {
            "in": "query",
            "name": "include_discarded",
            "required": false,
            "schema": {
              "default": true,
              "title": "Include Discarded",
              "type": "boolean"
            }
          },
          {
            "description": "Filter by start date (inclusive)",
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by start date (inclusive)",
              "title": "Start Date"
            }
          },
          {
            "description": "Filter by end date (inclusive)",
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by end date (inclusive)",
              "title": "End Date"
            }
          },
          {
            "description": "Filter by folder ID",
            "in": "query",
            "name": "folder_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by folder ID",
              "title": "Folder Id"
            }
          },
          {
            "description": "Filter by starred status",
            "in": "query",
            "name": "starred",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by starred status",
              "title": "Starred"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Conversation"
                  },
                  "title": "Response Get Conversations V1 Conversations Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversations",
        "tags": [
          "conversations"
        ]
      },
      "post": {
        "operationId": "process_in_progress_conversation_v1_conversations_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProcessConversationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateConversationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Process In Progress Conversation",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/count": {
      "get": {
        "operationId": "get_conversations_count_v1_conversations_count_get",
        "parameters": [
          {
            "description": "Comma-separated status filter (e.g. processing,completed)",
            "in": "query",
            "name": "statuses",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Comma-separated status filter (e.g. processing,completed)",
              "title": "Statuses"
            }
          },
          {
            "in": "query",
            "name": "include_discarded",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Discarded",
              "type": "boolean"
            }
          },
          {
            "description": "Filter by start date (inclusive)",
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by start date (inclusive)",
              "title": "Start Date"
            }
          },
          {
            "description": "Filter by end date (inclusive)",
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by end date (inclusive)",
              "title": "End Date"
            }
          },
          {
            "description": "Filter by folder ID",
            "in": "query",
            "name": "folder_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by folder ID",
              "title": "Folder Id"
            }
          },
          {
            "description": "Filter by starred status",
            "in": "query",
            "name": "starred",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by starred status",
              "title": "Starred"
            }
          },
          {
            "description": "Comma-separated source filter (e.g. friend,omi)",
            "in": "query",
            "name": "sources",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Comma-separated source filter (e.g. friend,omi)",
              "title": "Sources"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationsCountResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversations Count",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/from-segments": {
      "post": {
        "description": "Create a conversation from already-transcribed segments (Firebase-authed).\n\nUsed by clients that transcribe ON-DEVICE (e.g. the macOS desktop app with Parakeet) and need\nthe conversation persisted, processed (memories/summaries), and synced across devices — exactly\nlike a cloud-transcribed conversation, but without the live `/v4/listen` websocket.",
        "operationId": "create_conversation_from_segments_user_v1_conversations_from_segments_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateConversationFromTranscriptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationCreateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Conversation From Segments User",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/merge": {
      "post": {
        "description": "Merge multiple conversations into a new conversation (async).\n\nFlow:\n1. Validates conversations (locked? completed?)\n2. Returns immediately with 200 OK\n3. Background task creates new merged conversation\n4. Background task deletes source conversations\n5. FCM notification sent on completion\n\nThe merged conversation will have:\n- A new ID (source conversations are deleted)\n- Merged transcript segments with adjusted timestamps\n- Copied audio chunks\n- Regenerated title, summary, action items, memories via process_conversation()",
        "operationId": "merge_conversations_v1_conversations_merge_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MergeConversationsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MergeConversationsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Merge Conversations",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/search": {
      "post": {
        "operationId": "search_conversations_endpoint_v1_conversations_search_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SearchRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchConversationsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Conversations Endpoint",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}": {
      "delete": {
        "operationId": "delete_conversation_v1_conversations__conversation_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "cascade",
            "required": false,
            "schema": {
              "default": false,
              "title": "Cascade",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Conversation",
        "tags": [
          "conversations"
        ]
      },
      "get": {
        "description": "Detail responses include transcript fields when available. Locked or redacted conversations may include an empty transcript_segments array even though transcript data exists.",
        "operationId": "get_conversation_by_id_v1_conversations__conversation_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Conversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation By Id",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/action-items": {
      "delete": {
        "description": "Delete all action items for a specific conversation.",
        "operationId": "delete_conversation_action_items_v1_conversations__conversation_id__action_items_delete",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationActionItemsDeleteResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Conversation Action Items",
        "tags": [
          "action-items"
        ]
      },
      "get": {
        "description": "Get all action items for a specific conversation.",
        "operationId": "get_conversation_action_items_v1_conversations__conversation_id__action_items_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Action Items",
        "tags": [
          "action-items"
        ]
      },
      "patch": {
        "operationId": "set_action_item_status_v1_conversations__conversation_id__action_items_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetConversationActionItemsStateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Action Item Status",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/action-items/count": {
      "get": {
        "description": "Return total / completed / incomplete action-item counts for one conversation.\n\nA task-progress badge (e.g. 2 of 3 done) for a conversation without paging its items.",
        "operationId": "get_conversation_action_items_count_v1_conversations__conversation_id__action_items_count_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationActionItemsCountResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Action Items Count",
        "tags": [
          "action-items"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/action-items/{action_item_idx}": {
      "patch": {
        "operationId": "update_action_item_description_v1_conversations__conversation_id__action_items__action_item_idx__patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateActionItemDescriptionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Action Item Description",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/assign-speaker/{speaker_id}": {
      "patch": {
        "description": "Another complex endpoint.\n\nModify the assignee of all segments in the transcript of a conversation with the given speaker_id.\nBut,\nif `use_for_speech_training` is True, the corresponding audio segment will be used for speech training.\n\nSpeech training of whom?\n\nIf `assign_type` is 'is_user', the segment will be used for the user speech training.\nIf `assign_type` is 'person_id', the segment will be used for the person with the given id speech training.\n\nWhat is required for a segment to be used for speech training?\n1. The segment must have more than 5 words.\n2. The conversation audio file should be already stored in the user's bucket.\n\n:return: The updated conversation.",
        "operationId": "set_assignee_conversation_segment_v1_conversations__conversation_id__assign_speaker__speaker_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "speaker_id",
            "required": true,
            "schema": {
              "title": "Speaker Id",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "assign_type",
            "required": true,
            "schema": {
              "title": "Assign Type",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Value"
            }
          },
          {
            "in": "query",
            "name": "use_for_speech_training",
            "required": false,
            "schema": {
              "default": true,
              "title": "Use For Speech Training",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Conversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Assignee Conversation Segment",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/calendar-event": {
      "delete": {
        "description": "Unlink a calendar event from a conversation.\nThis removes the calendar_event field from the conversation.",
        "operationId": "unlink_calendar_event_v1_conversations__conversation_id__calendar_event_delete",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Unlink Calendar Event",
        "tags": [
          "conversations"
        ]
      },
      "post": {
        "description": "Link a specific Google Calendar event to an existing conversation.\nFetches the event details and stores the calendar_event on the conversation.",
        "operationId": "link_calendar_event_v1_conversations__conversation_id__calendar_event_post",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LinkCalendarEventRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEventLink"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Link Calendar Event",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/calendar-event/auto-link": {
      "post": {
        "description": "Auto-link a conversation to the best overlapping Google Calendar event.\nUses the conversation's started_at/finished_at to find a matching event.\nReturns 404 if no overlapping event is found.",
        "operationId": "auto_link_calendar_event_v1_conversations__conversation_id__calendar_event_auto_link_post",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEventLink"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Auto Link Calendar Event",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/events": {
      "patch": {
        "operationId": "set_conversation_events_state_v1_conversations__conversation_id__events_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetConversationEventsStateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Conversation Events State",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/finalization": {
      "get": {
        "operationId": "get_conversation_finalization_status_v1_conversations__conversation_id__finalization_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationFinalizationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Finalization Status",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/finalize": {
      "post": {
        "description": "Finalize exactly one backend conversation.\n\nUnlike POST /v1/conversations, this does not operate on the user's Redis\n\"current in-progress\" pointer, so desktop retry/rotation cannot accidentally\nfinalize a newer recording.",
        "operationId": "finalize_conversation_v1_conversations__conversation_id__finalize_post",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProcessConversationRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateConversationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Finalize Conversation",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/folder": {
      "patch": {
        "description": "Move a conversation to a different folder.",
        "operationId": "move_conversation_to_folder_v1_conversations__conversation_id__folder_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MoveConversationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Move Conversation To Folder",
        "tags": [
          "folders"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/photos": {
      "get": {
        "operationId": "get_conversation_photos_v1_conversations__conversation_id__photos_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ConversationPhoto"
                  },
                  "title": "Response Get Conversation Photos V1 Conversations  Conversation Id  Photos Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Photos",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/recording": {
      "get": {
        "operationId": "conversation_has_audio_recording_v1_conversations__conversation_id__recording_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationRecordingResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Conversation Has Audio Recording",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/reprocess": {
      "post": {
        "description": "Whenever a user wants to reprocess a conversation, or wants to force process a discarded one\n:param conversation_id: The ID of the conversation to reprocess\n:param language_code: Optional language code to use for processing\n:param app_id: Optional app ID to use for processing (if provided, only this app will be triggered)\n:return: The updated conversation after reprocessing.",
        "operationId": "reprocess_conversation_v1_conversations__conversation_id__reprocess_post",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "language_code",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Language Code"
            }
          },
          {
            "in": "query",
            "name": "app_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "App Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Conversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Reprocess Conversation",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/segments/assign-bulk": {
      "patch": {
        "operationId": "assign_segments_bulk_v1_conversations__conversation_id__segments_assign_bulk_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkAssignSegmentsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Conversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Assign Segments Bulk",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/segments/text": {
      "patch": {
        "operationId": "patch_conversation_segment_text_v1_conversations__conversation_id__segments_text_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSegmentTextRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Patch Conversation Segment Text",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/segments/{segment_idx}/assign": {
      "patch": {
        "description": "Another complex endpoint.\n\nModify the assignee of a segment in the transcript of a conversation.\nBut,\nif `use_for_speech_training` is True, the corresponding audio segment will be used for speech training.\n\nSpeech training of whom?\n\nIf `assign_type` is 'is_user', the segment will be used for the user speech training.\nIf `assign_type` is 'person_id', the segment will be used for the person with the given id speech training.\n\nWhat is required for a segment to be used for speech training?\n1. The segment must have more than 5 words.\n2. The conversation audio file shuold be already stored in the user's bucket.\n\n:return: The updated conversation.",
        "operationId": "set_assignee_conversation_segment_v1_conversations__conversation_id__segments__segment_idx__assign_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "segment_idx",
            "required": true,
            "schema": {
              "title": "Segment Idx",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "assign_type",
            "required": true,
            "schema": {
              "title": "Assign Type",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Value"
            }
          },
          {
            "in": "query",
            "name": "use_for_speech_training",
            "required": false,
            "schema": {
              "default": true,
              "title": "Use For Speech Training",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Conversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Assignee Conversation Segment",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/shared": {
      "get": {
        "operationId": "get_shared_conversation_by_id_v1_conversations__conversation_id__shared_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedConversationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Get Shared Conversation By Id",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/starred": {
      "patch": {
        "operationId": "set_conversation_starred_v1_conversations__conversation_id__starred_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "starred",
            "required": true,
            "schema": {
              "title": "Starred",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Conversation Starred",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/suggested-apps": {
      "get": {
        "operationId": "get_conversation_suggested_apps_v1_conversations__conversation_id__suggested_apps_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationSuggestedAppsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Suggested Apps",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/summary": {
      "patch": {
        "operationId": "patch_conversation_summary_v1_conversations__conversation_id__summary_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSummaryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Patch Conversation Summary",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/test-prompt": {
      "post": {
        "operationId": "test_prompt_v1_conversations__conversation_id__test_prompt_post",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TestPromptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationTestPromptResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Test Prompt",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/title": {
      "patch": {
        "operationId": "patch_conversation_title_v1_conversations__conversation_id__title_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "title",
            "required": true,
            "schema": {
              "title": "Title",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Patch Conversation Title",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/transcripts": {
      "get": {
        "operationId": "get_conversation_transcripts_by_models_v1_conversations__conversation_id__transcripts_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "additionalProperties": {
                    "items": {
                      "$ref": "#/components/schemas/TranscriptSegment"
                    },
                    "type": "array"
                  },
                  "title": "Response Get Conversation Transcripts By Models V1 Conversations  Conversation Id  Transcripts Get",
                  "type": "object"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Transcripts By Models",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/conversations/{conversation_id}/visibility": {
      "patch": {
        "operationId": "set_conversation_visibility_v1_conversations__conversation_id__visibility_patch",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/ConversationVisibility"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Conversation Visibility",
        "tags": [
          "conversations"
        ]
      }
    },
    "/v1/dev/keys": {
      "get": {
        "operationId": "listApiKeys",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DevApiKey"
                  },
                  "title": "Response Listapikeys",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Keys",
        "tags": [
          "API Keys"
        ]
      },
      "post": {
        "description": "Create a new Developer API key with optional scopes.\n\n- **name**: Descriptive name for the key\n- **scopes**: Optional list of scopes. If not provided, defaults to read-only access.\n  Available scopes:\n  - conversations:read\n  - conversations:write\n  - memories:read\n  - memories:write\n  - action_items:read\n  - action_items:write\n  - goals:read\n  - goals:write",
        "operationId": "createApiKey",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DevApiKeyCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DevApiKeyCreated"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Key",
        "tags": [
          "API Keys"
        ]
      }
    },
    "/v1/dev/keys/{key_id}": {
      "delete": {
        "operationId": "revokeApiKey",
        "parameters": [
          {
            "in": "path",
            "name": "key_id",
            "required": true,
            "schema": {
              "title": "Key Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Key",
        "tags": [
          "API Keys"
        ]
      }
    },
    "/v1/dev/user/action-items": {
      "get": {
        "description": "Get action items with optional filters. Locked action items are excluded.\n\n- **conversation_id**: Filter by conversation ID (None for standalone items)\n- **completed**: Filter by completion status\n- **start_date**: Filter by start date (inclusive)\n- **end_date**: Filter by end date (inclusive)\n- **limit**: Maximum number of items to return\n- **offset**: Number of items to skip",
        "operationId": "listActionItems",
        "parameters": [
          {
            "in": "query",
            "name": "conversation_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Conversation Id"
            }
          },
          {
            "in": "query",
            "name": "completed",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Completed"
            }
          },
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DeveloperActionItem"
                  },
                  "title": "Response Listactionitems",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Action Items",
        "tags": [
          "Action Items"
        ]
      },
      "post": {
        "description": "Create a new action item for the authenticated user.\n\n- **description**: The action item description (1-500 characters)\n- **completed**: Whether the action item is completed (default: False)\n- **due_at**: Optional due date in ISO 8601 format with timezone",
        "operationId": "createActionItem",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateActionItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperActionItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Action Item",
        "tags": [
          "Action Items"
        ]
      }
    },
    "/v1/dev/user/action-items/batch": {
      "post": {
        "description": "Create multiple action items in a batch.\n\n- **action_items**: List of action items to create (max 50)",
        "operationId": "createActionItemsBatch",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchActionItemsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchActionItemsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Action Items Batch",
        "tags": [
          "Action Items"
        ]
      }
    },
    "/v1/dev/user/action-items/{action_item_id}": {
      "delete": {
        "description": "Delete an action item by ID.\n\n- **action_item_id**: The ID of the action item to delete",
        "operationId": "deleteActionItem",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperSuccessResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Action Item",
        "tags": [
          "Action Items"
        ]
      },
      "patch": {
        "description": "Update an action item.\n\n- **action_item_id**: The ID of the action item to update\n- **description**: New description (optional)\n- **completed**: New completion status (optional)\n- **due_at**: New due date (optional, set to null to remove)",
        "operationId": "updateActionItem",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateActionItemRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperActionItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Action Item",
        "tags": [
          "Action Items"
        ]
      }
    },
    "/v1/dev/user/conversations": {
      "get": {
        "description": "Get conversations with optional transcript inclusion.\n\n- **include_transcript**: If True, includes full transcript_segments in the response\n- **folder_id**: Filter by folder ID (must be a non-empty string if provided)\n- **starred**: Filter by starred status (true/false)",
        "operationId": "listConversations",
        "parameters": [
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          },
          {
            "in": "query",
            "name": "categories",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Categories"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 25,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "include_transcript",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Transcript",
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "folder_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Folder Id"
            }
          },
          {
            "in": "query",
            "name": "starred",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Starred"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DeveloperConversation"
                  },
                  "title": "Response Listconversations",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversations",
        "tags": [
          "Conversations"
        ]
      },
      "post": {
        "description": "Create a new conversation from text for the authenticated user.\n\nThis endpoint processes the provided text through the full conversation pipeline:\n- Generates structured data (title, overview, category, emoji)\n- Extracts action items (with deduplication)\n- Extracts memories (with quality filtering)\n- Determines if conversation should be discarded\n- Triggers app integrations\n- Triggers webhooks\n\n**Request Parameters:**\n- **text**: The conversation text/transcript (1-100,000 characters)\n- **text_source**: Source type - audio_transcript, message, or other_text (default: other_text)\n- **text_source_spec**: Additional source info (e.g., 'email', 'slack')\n- **started_at**: When conversation started (defaults to now)\n- **finished_at**: When conversation finished (defaults to started_at + 5 minutes)\n- **language**: Language code (default: 'en')\n- **geolocation**: Optional geolocation data\n\n**Response:**\n- Returns the created conversation ID and status\n- Use GET /v1/dev/user/conversations/{id} to retrieve full details",
        "operationId": "createConversation",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateConversationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationCreateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Conversation",
        "tags": [
          "Conversations"
        ]
      }
    },
    "/v1/dev/user/conversations/from-segments": {
      "post": {
        "description": "Create a new conversation from structured transcript segments.\n\nThis endpoint is for advanced integrations that have speaker diarization and timing information.\nIt processes the transcript segments through the full conversation pipeline.\n\n**Transcript Segments:**\n- **text**: The text spoken (required)\n- **speaker**: Speaker identifier like 'SPEAKER_00', 'SPEAKER_01' (default: 'SPEAKER_00')\n- **speaker_id**: Numeric speaker ID (auto-calculated from speaker if not provided)\n- **is_user**: Whether this segment is from the user (default: False)\n- **person_id**: ID of known person speaking (optional)\n- **start**: Start time in seconds, e.g., 0.0, 1.5, 60.2 (required)\n- **end**: End time in seconds, e.g., 1.5, 3.0, 65.8 (required)\n\n**Other Parameters:**\n- **source**: Source of conversation (default: external_integration). Options:\n  - omi, friend, openglass, phone, desktop, apple_watch, bee, plaud, frame, etc.\n- **started_at**: When conversation started (defaults to now)\n- **finished_at**: When conversation finished (calculated from last segment if not provided)\n- **language**: Language code (default: 'en')\n- **geolocation**: Optional geolocation data\n\n**Example:**\n```json\n{\n  \"transcript_segments\": [\n    {\n      \"text\": \"Hey, how are you doing?\",\n      \"speaker\": \"SPEAKER_00\",\n      \"is_user\": true,\n      \"start\": 0.0,\n      \"end\": 2.5\n    },\n    {\n      \"text\": \"I'm doing great, thanks!\",\n      \"speaker\": \"SPEAKER_01\",\n      \"is_user\": false,\n      \"start\": 2.8,\n      \"end\": 5.2\n    }\n  ],\n  \"source\": \"phone\",\n  \"language\": \"en\"\n}\n```",
        "operationId": "createConversationFromSegments",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateConversationFromTranscriptRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ConversationCreateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Conversation From Segments",
        "tags": [
          "Conversations"
        ]
      }
    },
    "/v1/dev/user/conversations/{conversation_id}": {
      "delete": {
        "description": "Delete a conversation by ID.\n\nThis also deletes any associated photos in the conversation's subcollection.\n\n- **conversation_id**: The ID of the conversation to delete",
        "operationId": "deleteConversation",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperSuccessResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Conversation Endpoint",
        "tags": [
          "Conversations"
        ]
      },
      "get": {
        "description": "Get a single conversation by ID.\n\n- **conversation_id**: The ID of the conversation to retrieve\n- **include_transcript**: If True, includes full transcript_segments in the response",
        "operationId": "getConversation",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "include_transcript",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Transcript",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperConversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation Endpoint",
        "tags": [
          "Conversations"
        ]
      },
      "patch": {
        "description": "Update a conversation's title or discard status.\n\n- **conversation_id**: The ID of the conversation to update\n- **title**: New title for the conversation (optional)\n- **discarded**: Whether the conversation is discarded (optional)",
        "operationId": "updateConversation",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateConversationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperConversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Conversation Endpoint",
        "tags": [
          "Conversations"
        ]
      }
    },
    "/v1/dev/user/folders": {
      "get": {
        "description": "Get all folders for the authenticated user.\n\nThis endpoint is strictly read-only and returns an empty list if the user has no folders.\nUnlike the internal `/v1/folders` endpoint, it does NOT call `initialize_system_folders`,\nbecause doing so under a `conversations:read` scope would silently write to Firestore\n(violating the read-only contract) and opens a TOCTOU window where concurrent first\nrequests can race past the outer empty-check and create duplicate system folders.\n\nSystem folders (Work, Personal, Social) are still initialized lazily through other paths:\n- The mobile app calls the internal `GET /v1/folders` whenever the conversations screen\n  is rendered (`app/lib/pages/conversations/conversations_page.dart`), which triggers\n  `initialize_system_folders` on first access.\n- The conversation post-processing pipeline calls `initialize_system_folders` whenever\n  a new conversation is created (`backend/utils/conversations/process_conversation.py`).\n\nIn practice, any user who can issue a Developer API key has already gone through one of\nthose paths, so the empty-list case here only affects users who have never opened the\nconversations tab nor created a single conversation.",
        "operationId": "listFolders",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DeveloperFolder"
                  },
                  "title": "Response Listfolders",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Folders",
        "tags": [
          "Folders"
        ]
      }
    },
    "/v1/dev/user/goals": {
      "get": {
        "description": "Get user goals.\n\n- **limit**: Maximum number of goals to return\n- **include_inactive**: If True, includes inactive/completed goals",
        "operationId": "listGoals",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "include_inactive",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Inactive",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DeveloperGoal"
                  },
                  "title": "Response Listgoals",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goals",
        "tags": [
          "Goals"
        ]
      },
      "post": {
        "description": "Create a durable goal. Metrics are optional and other goals are never changed implicitly.\n\n- **title**: The goal title/description (1-500 characters)\n- **goal_type**: Optional metric type: boolean, scale, or numeric\n- **target_value**: Optional target value\n- **current_value**: Optional current progress\n- **min_value**: Optional minimum scale value\n- **max_value**: Optional maximum scale value\n- **unit**: Optional unit label (e.g., 'users', 'points')\n\nOmit all metric fields to create a qualitative goal.",
        "operationId": "createGoal",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGoalRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperGoal"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Goal",
        "tags": [
          "Goals"
        ]
      }
    },
    "/v1/dev/user/goals/{goal_id}": {
      "delete": {
        "description": "Delete a goal by ID.\n\n- **goal_id**: The ID of the goal to delete",
        "operationId": "deleteGoal",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperSuccessResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Goal",
        "tags": [
          "Goals"
        ]
      },
      "get": {
        "description": "Get a single goal by ID.\n\n- **goal_id**: The ID of the goal to retrieve",
        "operationId": "getGoal",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperGoal"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goal",
        "tags": [
          "Goals"
        ]
      },
      "patch": {
        "description": "Update a goal.\n\n- **goal_id**: The ID of the goal to update\n- **title**: New title (optional)\n- **target_value**: New target value (optional)\n- **current_value**: New progress value (optional)\n- **min_value**: New minimum value (optional)\n- **max_value**: New maximum value (optional)\n- **unit**: New unit label (optional)",
        "operationId": "updateGoal",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGoalRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperGoal"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Goal",
        "tags": [
          "Goals"
        ]
      }
    },
    "/v1/dev/user/goals/{goal_id}/history": {
      "get": {
        "description": "Get progress history for a goal.\n\n- **goal_id**: The ID of the goal\n- **days**: Number of days of history to return (max 365, default 30)",
        "operationId": "listGoalHistory",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "days",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 365,
              "minimum": 1,
              "title": "Days",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/GoalHistoryEntryResponse"
                  },
                  "title": "Response Listgoalhistory",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goal History",
        "tags": [
          "Goals"
        ]
      }
    },
    "/v1/dev/user/goals/{goal_id}/progress": {
      "patch": {
        "description": "Update the progress value of a goal.\n\n- **goal_id**: The ID of the goal to update\n- **current_value**: New progress value (query parameter)",
        "operationId": "updateGoalProgress",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "description": "New progress value",
            "in": "query",
            "name": "current_value",
            "required": true,
            "schema": {
              "description": "New progress value",
              "title": "Current Value",
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperGoal"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Goal Progress",
        "tags": [
          "Goals"
        ]
      }
    },
    "/v1/dev/user/memories": {
      "get": {
        "operationId": "listMemories",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 25,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "categories",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Categories"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/DeveloperMemory"
                  },
                  "title": "Response Listmemories",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Memories",
        "tags": [
          "Memories"
        ]
      },
      "post": {
        "description": "Create a new memory for the authenticated user.\n\n- **content**: The content of the memory (1-500 characters)\n- **category**: Memory category (auto-categorized if not provided)\n- **visibility**: Visibility: public or private (default: private)\n- **tags**: List of tags associated with the memory",
        "operationId": "createMemory",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateMemoryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperMemory"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Memory",
        "tags": [
          "Memories"
        ]
      }
    },
    "/v1/dev/user/memories/batch": {
      "post": {
        "description": "Create multiple memories in a batch.\n\n- **memories**: List of memories to create (max 25)",
        "operationId": "createMemoriesBatch",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchMemoriesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchMemoriesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Memories Batch",
        "tags": [
          "Memories"
        ]
      }
    },
    "/v1/dev/user/memories/vector/search": {
      "get": {
        "description": "Search developer-readable default memory memory through hydrated vector candidates.\n\nThis narrow developer API vector endpoint fails closed unless the authenticated\nDeveloper API app/key has a verified memories.read scope, a persisted app/key\ndefault-read grant, and the server-owned rollout state enables developer_api\nmemory default-memory reads. Vector hits are hydrated from authoritative\n`users/{uid}/memory_items` before returning results, so stale Short-term and\nArchive remain unavailable by default.",
        "operationId": "search_memories_vector_v1_dev_user_memories_vector_search_get",
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "minLength": 1,
              "title": "Query",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "maximum": 100,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperMemoryVectorSearchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Memories Vector",
        "tags": [
          "developer"
        ]
      }
    },
    "/v1/dev/user/memories/{memory_id}": {
      "delete": {
        "description": "Delete a memory by ID.\n\n- **memory_id**: The ID of the memory to delete",
        "operationId": "deleteMemory",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperSuccessResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Memory",
        "tags": [
          "Memories"
        ]
      },
      "patch": {
        "description": "Update a memory's content, visibility, tags, or category.\n\n- **memory_id**: The ID of the memory to update\n- **content**: New content for the memory (optional)\n- **visibility**: New visibility: public or private (optional)\n- **tags**: New tags for the memory (optional)\n- **category**: New category for the memory (optional)",
        "operationId": "updateMemory",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateMemoryRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeveloperMemory"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Memory",
        "tags": [
          "Memories"
        ]
      }
    },
    "/v1/fair-use/case/{case_ref}/status": {
      "get": {
        "description": "Public unauthenticated endpoint: look up case status by reference.\n\nReturns only non-sensitive info: stage, message, timestamps, support email.\nNo usage data or user identity exposed.",
        "operationId": "get_public_case_status_v1_fair_use_case__case_ref__status_get",
        "parameters": [
          {
            "in": "path",
            "name": "case_ref",
            "required": true,
            "schema": {
              "title": "Case Ref",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicFairUseCaseStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Public Case Status",
        "tags": [
          "fair_use"
        ]
      }
    },
    "/v1/fair-use/status": {
      "get": {
        "description": "User-facing endpoint: see your own fair-use status and speech usage.",
        "operationId": "get_my_fair_use_status_v1_fair_use_status_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FairUseStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get My Fair Use Status",
        "tags": [
          "fair_use"
        ]
      }
    },
    "/v1/folders": {
      "get": {
        "description": "Get all folders for the current user.\nInitializes system folders if this is the first access.",
        "operationId": "get_folders_v1_folders_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Folder"
                  },
                  "title": "Response Get Folders V1 Folders Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Folders",
        "tags": [
          "folders"
        ]
      },
      "post": {
        "description": "Create a new custom folder.",
        "operationId": "create_folder_v1_folders_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateFolderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Folder"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Folder",
        "tags": [
          "folders"
        ]
      }
    },
    "/v1/folders/reorder": {
      "post": {
        "description": "Reorder folders by providing an ordered list of folder IDs.",
        "operationId": "reorder_folders_v1_folders_reorder_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReorderFoldersRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FolderMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Reorder Folders",
        "tags": [
          "folders"
        ]
      }
    },
    "/v1/folders/{folder_id}": {
      "delete": {
        "description": "Delete a folder and move its conversations to another folder.",
        "operationId": "delete_folder_v1_folders__folder_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "folder_id",
            "required": true,
            "schema": {
              "title": "Folder Id",
              "type": "string"
            }
          },
          {
            "description": "Target folder for conversations (defaults to 'Other')",
            "in": "query",
            "name": "move_to_folder_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Target folder for conversations (defaults to 'Other')",
              "title": "Move To Folder Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Folder",
        "tags": [
          "folders"
        ]
      },
      "get": {
        "description": "Get a specific folder by ID.",
        "operationId": "get_folder_v1_folders__folder_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "folder_id",
            "required": true,
            "schema": {
              "title": "Folder Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Folder"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Folder",
        "tags": [
          "folders"
        ]
      },
      "patch": {
        "description": "Update folder metadata (name, description, color, icon, order).",
        "operationId": "update_folder_v1_folders__folder_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "folder_id",
            "required": true,
            "schema": {
              "title": "Folder Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateFolderRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Folder"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Folder",
        "tags": [
          "folders"
        ]
      }
    },
    "/v1/folders/{folder_id}/conversations": {
      "get": {
        "description": "Get all conversations in a folder with pagination.",
        "operationId": "get_folder_conversations_v1_folders__folder_id__conversations_get",
        "parameters": [
          {
            "in": "path",
            "name": "folder_id",
            "required": true,
            "schema": {
              "title": "Folder Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 1000,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "include_discarded",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Discarded",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Conversation"
                  },
                  "title": "Response Get Folder Conversations V1 Folders  Folder Id  Conversations Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Folder Conversations",
        "tags": [
          "folders"
        ]
      }
    },
    "/v1/folders/{folder_id}/conversations/bulk-move": {
      "post": {
        "description": "Move multiple conversations to a folder.",
        "operationId": "bulk_move_conversations_v1_folders__folder_id__conversations_bulk_move_post",
        "parameters": [
          {
            "in": "path",
            "name": "folder_id",
            "required": true,
            "schema": {
              "title": "Folder Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BulkMoveConversationsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkMoveConversationsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Bulk Move Conversations",
        "tags": [
          "folders"
        ]
      }
    },
    "/v1/goals": {
      "get": {
        "description": "Get the current active goal for the user (backward compatibility).",
        "operationId": "get_current_goal_v1_goals_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/GoalResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "title": "Response Get Current Goal V1 Goals Get"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Current Goal",
        "tags": [
          "goals"
        ]
      },
      "post": {
        "description": "Create a durable goal without changing any other goal's focus or lifecycle.",
        "operationId": "create_goal_v1_goals_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoalCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Goal",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/advice": {
      "get": {
        "description": "Get AI-generated advice for the current active goal.",
        "operationId": "get_current_goal_advice_v1_goals_advice_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdviceResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Current Goal Advice",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/all": {
      "get": {
        "description": "Get all active goals; canonical clients opt into ended history.",
        "operationId": "get_all_goals_v1_goals_all_get",
        "parameters": [
          {
            "in": "query",
            "name": "include_ended",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Ended",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/GoalResponse"
                  },
                  "title": "Response Get All Goals V1 Goals All Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get All Goals",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/canonical": {
      "post": {
        "description": "Create a generation-scoped canonical goal with safe retry semantics.",
        "operationId": "create_canonical_goal_v1_goals_canonical_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoalCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Canonical Goal",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/extract-progress": {
      "post": {
        "description": "Extract goal progress from conversation/chat text and update if found.\nUses LLM to understand context and extract numeric progress.",
        "operationId": "extract_and_update_progress_v1_goals_extract_progress_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProgressExtractRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProgressExtractResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Extract And Update Progress",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/suggest": {
      "get": {
        "description": "Generate an AI-suggested goal based on user's memories and conversations.",
        "operationId": "suggest_goal_v1_goals_suggest_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalSuggestionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Suggest Goal",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}": {
      "delete": {
        "deprecated": true,
        "description": "Released compatibility route: soft-abandon and retain links. Use the lifecycle route for explicit disposition.",
        "operationId": "delete_goal_v1_goals__goal_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalDeleteResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Goal",
        "tags": [
          "goals"
        ]
      },
      "patch": {
        "description": "Update an existing goal.",
        "operationId": "update_goal_v1_goals__goal_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoalUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Goal",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/advice": {
      "get": {
        "description": "Get AI-generated actionable advice for achieving a goal.",
        "operationId": "get_goal_advice_v1_goals__goal_id__advice_get",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AdviceResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goal Advice",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/detail": {
      "get": {
        "operationId": "get_goal_detail_v1_goals__goal_id__detail_get",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalDetailProjection"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goal Detail",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/focus": {
      "delete": {
        "operationId": "unfocus_goal_v1_goals__goal_id__focus_delete",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Unfocus Goal",
        "tags": [
          "goals"
        ]
      },
      "post": {
        "operationId": "focus_goal_v1_goals__goal_id__focus_post",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoalFocusRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Focus Goal",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/history": {
      "get": {
        "description": "Get progress history for a goal.",
        "operationId": "get_goal_history_v1_goals__goal_id__history_get",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "days",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 365,
              "minimum": 1,
              "title": "Days",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/GoalHistoryEntryResponse"
                  },
                  "title": "Response Get Goal History V1 Goals  Goal Id  History Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goal History",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/lifecycle": {
      "post": {
        "operationId": "transition_goal_lifecycle_v1_goals__goal_id__lifecycle_post",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoalLifecycleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Transition Goal Lifecycle",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/progress": {
      "patch": {
        "description": "Update the progress value of a goal.",
        "operationId": "update_goal_progress_v1_goals__goal_id__progress_patch",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "description": "New progress value",
            "in": "query",
            "name": "current_value",
            "required": true,
            "schema": {
              "description": "New progress value",
              "title": "Current Value",
              "type": "number"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Goal Progress",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/goals/{goal_id}/progress-events": {
      "get": {
        "operationId": "list_goal_progress_events_v1_goals__goal_id__progress_events_get",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/GoalProgressEvent"
                  },
                  "title": "Response List Goal Progress Events V1 Goals  Goal Id  Progress Events Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Goal Progress Events",
        "tags": [
          "goals"
        ]
      },
      "post": {
        "operationId": "append_goal_progress_event_v1_goals__goal_id__progress_events_post",
        "parameters": [
          {
            "in": "path",
            "name": "goal_id",
            "required": true,
            "schema": {
              "title": "Goal Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GoalProgressEventCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GoalProgressEvent"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Append Goal Progress Event",
        "tags": [
          "goals"
        ]
      }
    },
    "/v1/import/jobs": {
      "get": {
        "description": "Get all import jobs for the current user.\n\nReturns:\n    List of import jobs ordered by creation date (newest first)",
        "operationId": "get_import_jobs_v1_import_jobs_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ImportJobResponse"
                  },
                  "title": "Response Get Import Jobs V1 Import Jobs Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Import Jobs",
        "tags": [
          "import"
        ]
      }
    },
    "/v1/import/jobs/{job_id}": {
      "delete": {
        "description": "Delete a finished (completed, failed, or cancelled) import job.",
        "operationId": "delete_import_job_v1_import_jobs__job_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteImportJobResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Import Job",
        "tags": [
          "import"
        ]
      },
      "get": {
        "description": "Get the status of a specific import job.\n\nArgs:\n    job_id: The import job ID\n\nReturns:\n    ImportJobResponse with current job status and progress",
        "operationId": "get_import_job_status_v1_import_jobs__job_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportJobResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Import Job Status",
        "tags": [
          "import"
        ]
      }
    },
    "/v1/import/jobs/{job_id}/cancel": {
      "post": {
        "description": "Cancel a pending or processing import job.",
        "operationId": "cancel_import_job_v1_import_jobs__job_id__cancel_post",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportJobResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Cancel Import Job",
        "tags": [
          "import"
        ]
      }
    },
    "/v1/import/limitless": {
      "post": {
        "description": "Start a Limitless data import from a ZIP file export.\n\nThe import runs in the background. Use GET /v1/import/jobs/{job_id} to check status.\n\nArgs:\n    file: ZIP file containing Limitless data export\n    language: Language code for conversation processing (default: 'en')\n\nReturns:\n    ImportJobResponse with job_id and initial status",
        "operationId": "import_limitless_data_v1_import_limitless_post",
        "parameters": [
          {
            "in": "query",
            "name": "language",
            "required": false,
            "schema": {
              "default": "en",
              "title": "Language",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_import_limitless_data_v1_import_limitless_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportJobResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Import Limitless Data",
        "tags": [
          "import"
        ]
      }
    },
    "/v1/import/limitless/conversations": {
      "delete": {
        "description": "Delete all conversations imported from Limitless.\n\nReturns:\n    Number of deleted conversations",
        "operationId": "delete_limitless_conversations_v1_import_limitless_conversations_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteLimitlessConversationsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Limitless Conversations",
        "tags": [
          "import"
        ]
      }
    },
    "/v1/integrations/apple-health/sync": {
      "put": {
        "description": "Sync Apple Health data from the iOS device.\n\nThis endpoint receives health data collected from Apple HealthKit on the user's\niPhone/Apple Watch and stores it for use in chat queries.\n\nUnlike other integrations that use OAuth, Apple Health data is pushed from the device.",
        "operationId": "sync_apple_health_data_v1_integrations_apple_health_sync_put",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AppleHealthSyncData"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppleHealthSyncResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Sync Apple Health Data",
        "tags": [
          "integrations"
        ]
      }
    },
    "/v1/integrations/notification": {
      "post": {
        "operationId": "send_app_notification_to_user_v1_integrations_notification_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": true,
                "title": "Data",
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrationNotificationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Send App Notification To User"
      }
    },
    "/v1/integrations/{app_key}": {
      "delete": {
        "description": "Delete an integration connection.",
        "operationId": "delete_integration_v1_integrations__app_key__delete",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Integration",
        "tags": [
          "integrations"
        ]
      },
      "get": {
        "description": "Get integration connection status for the current user.",
        "operationId": "get_integration_v1_integrations__app_key__get",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Integration",
        "tags": [
          "integrations"
        ]
      },
      "put": {
        "description": "Save or update an integration connection.",
        "operationId": "save_integration_v1_integrations__app_key__put",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IntegrationData"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IntegrationMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Save Integration",
        "tags": [
          "integrations"
        ]
      }
    },
    "/v1/integrations/{app_key}/oauth-url": {
      "get": {
        "description": "Get OAuth authorization URL for an integration.\nFrontend opens this URL in browser to start OAuth flow.\nUses secure random state tokens to prevent CSRF attacks.",
        "operationId": "get_oauth_url_v1_integrations__app_key__oauth_url_get",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthUrlResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Oauth Url",
        "tags": [
          "integrations"
        ]
      }
    },
    "/v1/knowledge-graph": {
      "delete": {
        "operationId": "delete_knowledge_graph_v1_knowledge_graph_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteKnowledgeGraphResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Knowledge Graph",
        "tags": [
          "knowledge_graph"
        ]
      },
      "get": {
        "operationId": "get_knowledge_graph_v1_knowledge_graph_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/KnowledgeGraphResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Knowledge Graph",
        "tags": [
          "knowledge_graph"
        ]
      }
    },
    "/v1/knowledge-graph/rebuild": {
      "post": {
        "operationId": "rebuild_graph_v1_knowledge_graph_rebuild_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RebuildResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Rebuild Graph",
        "tags": [
          "knowledge_graph"
        ]
      }
    },
    "/v1/mcp/action-items": {
      "get": {
        "operationId": "get_action_items_v1_mcp_action_items_get",
        "parameters": [
          {
            "in": "query",
            "name": "completed",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Completed"
            }
          },
          {
            "in": "query",
            "name": "due_start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Due Start Date"
            }
          },
          {
            "in": "query",
            "name": "due_end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Due End Date"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SimpleActionItem"
                  },
                  "title": "Response Get Action Items V1 Mcp Action Items Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Action Items",
        "tags": [
          "mcp"
        ]
      },
      "post": {
        "operationId": "create_action_item_v1_mcp_action_items_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/McpCreateActionItem"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SimpleActionItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Action Item",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/action-items/search": {
      "get": {
        "operationId": "search_action_items_v1_mcp_action_items_search_get",
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "title": "Query",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SimpleActionItem"
                  },
                  "title": "Response Search Action Items V1 Mcp Action Items Search Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Action Items",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/action-items/{action_item_id}": {
      "delete": {
        "operationId": "delete_action_item_v1_mcp_action_items__action_item_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Action Item",
        "tags": [
          "mcp"
        ]
      },
      "patch": {
        "operationId": "update_action_item_v1_mcp_action_items__action_item_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/McpUpdateActionItem"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SimpleActionItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Action Item",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/action-items/{action_item_id}/complete": {
      "post": {
        "operationId": "complete_action_item_v1_mcp_action_items__action_item_id__complete_post",
        "parameters": [
          {
            "in": "path",
            "name": "action_item_id",
            "required": true,
            "schema": {
              "title": "Action Item Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "completed",
            "required": false,
            "schema": {
              "default": true,
              "title": "Completed",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SimpleActionItem"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Complete Action Item",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/chat": {
      "get": {
        "operationId": "get_chat_messages_v1_mcp_chat_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 50,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SimpleChatMessage"
                  },
                  "title": "Response Get Chat Messages V1 Mcp Chat Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Chat Messages",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/conversations": {
      "get": {
        "operationId": "get_conversations_v1_mcp_conversations_get",
        "parameters": [
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          },
          {
            "in": "query",
            "name": "categories",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Categories"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SimpleConversation"
                  },
                  "title": "Response Get Conversations V1 Mcp Conversations Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversations",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/conversations/search": {
      "get": {
        "operationId": "search_conversations_v1_mcp_conversations_search_get",
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "title": "Query",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SimpleConversation"
                  },
                  "title": "Response Search Conversations V1 Mcp Conversations Search Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Conversations",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/conversations/{conversation_id}": {
      "get": {
        "operationId": "get_conversation_by_id_v1_mcp_conversations__conversation_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FullConversation"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Conversation By Id",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/daily-summaries": {
      "get": {
        "operationId": "get_daily_summaries_v1_mcp_daily_summaries_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 30,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "additionalProperties": true,
                    "type": "object"
                  },
                  "title": "Response Get Daily Summaries V1 Mcp Daily Summaries Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Daily Summaries",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/goals": {
      "get": {
        "operationId": "get_goals_v1_mcp_goals_get",
        "parameters": [
          {
            "in": "query",
            "name": "include_inactive",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Inactive",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "additionalProperties": true,
                    "type": "object"
                  },
                  "title": "Response Get Goals V1 Mcp Goals Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Goals",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/keys": {
      "get": {
        "operationId": "get_keys_v1_mcp_keys_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/McpApiKey"
                  },
                  "title": "Response Get Keys V1 Mcp Keys Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Keys",
        "tags": [
          "mcp"
        ]
      },
      "post": {
        "operationId": "create_key_v1_mcp_keys_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/McpApiKeyCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpApiKeyCreated"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Key",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/keys/{key_id}": {
      "delete": {
        "operationId": "delete_key_v1_mcp_keys__key_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "key_id",
            "required": true,
            "schema": {
              "title": "Key Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Key",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/memories": {
      "get": {
        "operationId": "get_memories_v1_mcp_memories_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 25,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "categories",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Categories"
            }
          },
          {
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "default": "created_desc",
              "title": "Sort",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "reviewed",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Reviewed"
            }
          },
          {
            "in": "query",
            "name": "manually_added",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Manually Added"
            }
          },
          {
            "in": "query",
            "name": "updated_after",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Updated After"
            }
          },
          {
            "in": "query",
            "name": "include_activity",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Activity",
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "include_sensitive",
            "required": false,
            "schema": {
              "default": true,
              "title": "Include Sensitive",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/CleanerMemory"
                  },
                  "title": "Response Get Memories V1 Mcp Memories Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Memories",
        "tags": [
          "mcp"
        ]
      },
      "post": {
        "operationId": "create_memory_v1_mcp_memories_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Memory"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Memory"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Memory",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/memories/search": {
      "get": {
        "operationId": "search_memories_v1_mcp_memories_search_get",
        "parameters": [
          {
            "in": "query",
            "name": "query",
            "required": true,
            "schema": {
              "title": "Query",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 10,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SearchedMemory"
                  },
                  "title": "Response Search Memories V1 Mcp Memories Search Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Memories",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/memories/{memory_id}": {
      "delete": {
        "operationId": "delete_memory_v1_mcp_memories__memory_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Memory",
        "tags": [
          "mcp"
        ]
      },
      "patch": {
        "operationId": "edit_memory_v1_mcp_memories__memory_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Edit Memory",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/oauth/grants": {
      "get": {
        "operationId": "get_oauth_grants_v1_mcp_oauth_grants_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpOauthGrantsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Oauth Grants",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/oauth/grants/{grant_id}": {
      "delete": {
        "operationId": "revoke_oauth_grant_v1_mcp_oauth_grants__grant_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "grant_id",
            "required": true,
            "schema": {
              "title": "Grant Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Revoke Oauth Grant",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/people": {
      "get": {
        "operationId": "get_people_v1_mcp_people_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/SimplePerson"
                  },
                  "title": "Response Get People V1 Mcp People Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get People",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/profile": {
      "get": {
        "description": "Omi's cached high-level user profile, if one has been generated.",
        "operationId": "get_user_profile_v1_mcp_profile_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserProfile"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Profile",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/screen-activity": {
      "get": {
        "operationId": "get_screen_activity_v1_mcp_screen_activity_get",
        "parameters": [
          {
            "in": "query",
            "name": "start_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Start Date"
            }
          },
          {
            "in": "query",
            "name": "end_date",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date-time",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "End Date"
            }
          },
          {
            "in": "query",
            "name": "app",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "App"
            }
          },
          {
            "in": "query",
            "name": "summary",
            "required": false,
            "schema": {
              "default": false,
              "title": "Summary",
              "type": "boolean"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 200,
              "title": "Limit",
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "items": {
                        "$ref": "#/components/schemas/McpScreenActivityRow"
                      },
                      "type": "array"
                    },
                    {
                      "$ref": "#/components/schemas/McpScreenActivitySummaryResponse"
                    }
                  ],
                  "title": "Response Get Screen Activity V1 Mcp Screen Activity Get"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Screen Activity",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/sse": {
      "delete": {
        "description": "Delete/terminate an MCP session.",
        "operationId": "mcp_delete_session_v1_mcp_sse_delete",
        "parameters": [
          {
            "in": "header",
            "name": "Mcp-Session-Id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Mcp-Session-Id"
            }
          },
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Mcp Delete Session",
        "tags": [
          "mcp"
        ]
      },
      "get": {
        "description": "SSE endpoint for server-initiated messages (optional).\n\nClients can GET this endpoint to listen for server-initiated notifications.\nThis is optional per the MCP spec and mainly used for long-polling scenarios.",
        "operationId": "mcp_sse_get_v1_mcp_sse_get",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "Mcp-Session-Id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Mcp-Session-Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Mcp Sse Get",
        "tags": [
          "mcp"
        ]
      },
      "head": {
        "operationId": "mcp_sse_head_v1_mcp_sse_head",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "summary": "Mcp Sse Head",
        "tags": [
          "mcp"
        ]
      },
      "post": {
        "description": "Streamable HTTP Transport endpoint for MCP clients.\n\nThis implements the MCP 2025-03-26 Streamable HTTP Transport specification.\n\n- POST JSON-RPC messages to this endpoint\n- Responses are returned as SSE stream or JSON depending on Accept header\n- This hosted transport is stateless; bearer-token auth scopes every request",
        "operationId": "mcp_streamable_http_v1_mcp_sse_post",
        "parameters": [
          {
            "in": "header",
            "name": "Authorization",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Authorization"
            }
          },
          {
            "in": "header",
            "name": "Mcp-Session-Id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Mcp-Session-Id"
            }
          },
          {
            "in": "header",
            "name": "Accept",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Accept"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Mcp Streamable Http",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/mcp/sse/info": {
      "get": {
        "description": "Get information about the pre-hosted MCP server.",
        "operationId": "mcp_sse_info_v1_mcp_sse_info_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/McpSseInfoResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Mcp Sse Info",
        "tags": [
          "mcp"
        ]
      }
    },
    "/v1/payment-methods/default": {
      "post": {
        "description": "Set the default payment method for the user",
        "operationId": "set_default_payment_method_endpoint_v1_payment_methods_default_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetDefaultPaymentMethodRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Default Payment Method Endpoint"
      }
    },
    "/v1/payment-methods/status": {
      "get": {
        "description": "Get the statuses of the payment methods for the user",
        "operationId": "get_payment_method_status_v1_payment_methods_status_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentMethodStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Payment Method Status"
      }
    },
    "/v1/payments/available-plans": {
      "get": {
        "description": "Get available subscription plans with their price IDs and billing intervals.",
        "operationId": "get_available_plans_endpoint_v1_payments_available_plans_get",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AvailablePlansResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Available Plans Endpoint"
      }
    },
    "/v1/payments/cancel": {
      "get": {
        "operationId": "stripe_cancel_v1_payments_cancel_get",
        "responses": {
          "200": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Stripe Cancel"
      }
    },
    "/v1/payments/checkout-session": {
      "post": {
        "operationId": "create_checkout_session_endpoint_v1_payments_checkout_session_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckoutRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentCheckoutSessionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Checkout Session Endpoint"
      }
    },
    "/v1/payments/customer-portal": {
      "post": {
        "description": "Create a Stripe Customer Portal session for managing payment methods and subscriptions.",
        "operationId": "create_customer_portal_endpoint_v1_payments_customer_portal_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerPortalSessionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Customer Portal Endpoint"
      }
    },
    "/v1/payments/overage-info": {
      "get": {
        "description": "Explain overage billing + return the user's current accrued charge.\n\nPowers the clickable \"What happens past the limit?\" text on the plan page.\nSafe to call on any plan — non-overage plans just get a zero snapshot plus\nthe explainer copy.",
        "operationId": "get_overage_info_endpoint_v1_payments_overage_info_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OverageInfoResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Overage Info Endpoint"
      }
    },
    "/v1/payments/portal-return": {
      "get": {
        "operationId": "portal_return_v1_payments_portal_return_get",
        "responses": {
          "200": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Portal Return"
      }
    },
    "/v1/payments/subscription": {
      "delete": {
        "operationId": "cancel_subscription_endpoint_v1_payments_subscription_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelSubscriptionRequest",
                "default": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentStatusMessageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Cancel Subscription Endpoint"
      }
    },
    "/v1/payments/success": {
      "get": {
        "operationId": "stripe_success_v1_payments_success_get",
        "parameters": [
          {
            "in": "query",
            "name": "session_id",
            "required": true,
            "schema": {
              "title": "Session Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Stripe Success"
      }
    },
    "/v1/payments/upgrade-subscription": {
      "post": {
        "description": "Upgrade or change a user's subscription plan.\n\n- Cross-plan changes (e.g. Unlimited→Pro): immediate swap via Subscription.modify(),\n  Stripe prorates automatically. User gets new features right away.\n- Same plan, different interval (e.g. monthly→annual): scheduled via SubscriptionSchedule,\n  takes effect at end of current billing period.",
        "operationId": "upgrade_subscription_endpoint_v1_payments_upgrade_subscription_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpgradeSubscriptionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentUpgradeSubscriptionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Upgrade Subscription Endpoint"
      }
    },
    "/v1/paypal/payment-details": {
      "get": {
        "description": "Get the PayPal payment details for the user",
        "operationId": "get_paypal_payment_details_endpoint_v1_paypal_payment_details_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/PayPalPaymentDetailsResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "title": "Response Get Paypal Payment Details Endpoint V1 Paypal Payment Details Get"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Paypal Payment Details Endpoint"
      },
      "post": {
        "description": "Save PayPal payment details (email and paypal.me link)",
        "operationId": "save_paypal_payment_details_v1_paypal_payment_details_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SavePayPalPaymentDetailsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Save Paypal Payment Details"
      }
    },
    "/v1/phone/numbers": {
      "get": {
        "description": "List all verified phone numbers for the user.",
        "operationId": "list_phone_numbers_v1_phone_numbers_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneNumbersResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Phone Numbers",
        "tags": [
          "phone-calls"
        ]
      }
    },
    "/v1/phone/numbers/verify": {
      "post": {
        "description": "Initiate phone number verification via Twilio caller ID validation.",
        "operationId": "verify_phone_number_v1_phone_numbers_verify_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerifyPhoneNumberRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerifyPhoneNumberResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Verify Phone Number",
        "tags": [
          "phone-calls"
        ]
      }
    },
    "/v1/phone/numbers/verify/check": {
      "post": {
        "description": "Check if a phone number has been verified. Poll this endpoint every 2s (60s timeout).",
        "operationId": "check_phone_verification_v1_phone_numbers_verify_check_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckVerificationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckVerificationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Check Phone Verification",
        "tags": [
          "phone-calls"
        ]
      }
    },
    "/v1/phone/numbers/{phone_number_id}": {
      "delete": {
        "description": "Remove a verified phone number.",
        "operationId": "remove_phone_number_v1_phone_numbers__phone_number_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "phone_number_id",
            "required": true,
            "schema": {
              "title": "Phone Number Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PhoneMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Remove Phone Number",
        "tags": [
          "phone-calls"
        ]
      }
    },
    "/v1/phone/token": {
      "post": {
        "description": "Generate a Twilio access token for making VoIP calls.",
        "operationId": "get_phone_token_v1_phone_token_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TokenResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Phone Token",
        "tags": [
          "phone-calls"
        ]
      }
    },
    "/v1/phone/twiml": {
      "post": {
        "description": "TwiML webhook called by Twilio when a VoIP call is initiated from the client SDK.\n\nTwilio POSTs form data with params set by ConnectOptions (To, CallId).\nThe 'From' field is the SDK identity (uid), NOT a phone number.\nWe look up the user's verified caller ID from the database.",
        "operationId": "twiml_voice_webhook_v1_phone_twiml_post",
        "responses": {
          "200": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Twiml Voice Webhook",
        "tags": [
          "phone-calls"
        ]
      }
    },
    "/v1/stripe/connect-accounts": {
      "post": {
        "description": "Create a Stripe Connect account and return the account creation response",
        "operationId": "create_connect_account_endpoint_v1_stripe_connect_accounts_post",
        "parameters": [
          {
            "in": "query",
            "name": "country",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Country"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StripeConnectAccountResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Connect Account Endpoint"
      }
    },
    "/v1/stripe/connect/webhook": {
      "post": {
        "operationId": "stripe_connect_webhook_v1_stripe_connect_webhook_post",
        "parameters": [
          {
            "in": "header",
            "name": "stripe-signature",
            "required": false,
            "schema": {
              "title": "Stripe-Signature",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Stripe Connect Webhook",
        "tags": [
          "v1",
          "stripe",
          "webhook"
        ]
      }
    },
    "/v1/stripe/onboarded": {
      "get": {
        "description": "Check the onboarding status of a Connect account",
        "operationId": "check_onboarding_status_v1_stripe_onboarded_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StripeOnboardingStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Check Onboarding Status",
        "tags": [
          "v1",
          "stripe"
        ]
      }
    },
    "/v1/stripe/refresh/{account_id}": {
      "post": {
        "description": "Generate a fresh account link if the previous one expired",
        "operationId": "refresh_account_link_endpoint_v1_stripe_refresh__account_id__post",
        "parameters": [
          {
            "in": "path",
            "name": "account_id",
            "required": true,
            "schema": {
              "title": "Account Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StripeConnectAccountResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Refresh Account Link Endpoint"
      }
    },
    "/v1/stripe/return/{account_id}": {
      "get": {
        "description": "Handle the return flow from Stripe Connect account creation",
        "operationId": "stripe_return_v1_stripe_return__account_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "account_id",
            "required": true,
            "schema": {
              "title": "Account Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "text/html": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Stripe Return"
      }
    },
    "/v1/stripe/supported-countries": {
      "get": {
        "operationId": "get_supported_countries_v1_stripe_supported_countries_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/StripeSupportedCountryResponse"
                  },
                  "title": "Response Get Supported Countries V1 Stripe Supported Countries Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Supported Countries"
      }
    },
    "/v1/stripe/webhook": {
      "post": {
        "operationId": "stripe_webhook_v1_stripe_webhook_post",
        "parameters": [
          {
            "in": "header",
            "name": "stripe-signature",
            "required": false,
            "schema": {
              "title": "Stripe-Signature",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Stripe Webhook",
        "tags": [
          "v1",
          "stripe",
          "webhook"
        ]
      }
    },
    "/v1/sync/audio/{conversation_id}/precache": {
      "post": {
        "description": "Warm the audio cache for a conversation.\nReturns immediately - caching happens in background.",
        "operationId": "precache_conversation_audio_endpoint_v1_sync_audio__conversation_id__precache_post",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AudioPrecacheResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Precache Conversation Audio Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/sync/audio/{conversation_id}/urls": {
      "get": {
        "description": "Get signed URLs for all audio files in a conversation.\nSynchronously caches the first uncached file for immediate playback.\nRemaining files are cached in background.\n\nReturns:\n    List of audio file info with signed_url (if cached) or status \"pending\"",
        "operationId": "get_audio_signed_urls_endpoint_v1_sync_audio__conversation_id__urls_get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AudioUrlsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Audio Signed Urls Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/sync/audio/{conversation_id}/{audio_file_id}": {
      "get": {
        "description": "Download audio file from private cloud sync in the specified format.\nMerges chunks on-demand.\n\nArgs:\n    conversation_id: ID of the conversation\n    audio_file_id: ID of the audio file within the conversation\n    request: FastAPI Request object (for Range header)\n    format: Output format - 'wav' or 'pcm' (raw) (default: wav)\n    uid: User ID (from authentication)\n\nReturns:\n    StreamingResponse with the audio file in the requested format.\n    Returns 206 Partial Content for Range requests, 200 OK for full file.",
        "operationId": "download_audio_file_endpoint_v1_sync_audio__conversation_id___audio_file_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "conversation_id",
            "required": true,
            "schema": {
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "audio_file_id",
            "required": true,
            "schema": {
              "title": "Audio File Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "default": "wav",
              "pattern": "^(wav|pcm)$",
              "title": "Format",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "audio/mpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "audio/wav": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Audio stream."
          },
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AudioDownloadPendingResponse"
                }
              }
            },
            "description": "Audio artifact is being prepared."
          },
          "206": {
            "content": {
              "application/octet-stream": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "audio/mpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              },
              "audio/wav": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Partial audio stream."
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Download Audio File Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/task-integrations": {
      "get": {
        "description": "Get all task integration connections for the current user.",
        "operationId": "get_task_integrations_v1_task_integrations_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskIntegrationsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Task Integrations",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/asana/projects/{workspace_gid}": {
      "get": {
        "description": "Get projects in an Asana workspace",
        "operationId": "get_asana_projects_v1_task_integrations_asana_projects__workspace_gid__get",
        "parameters": [
          {
            "in": "path",
            "name": "workspace_gid",
            "required": true,
            "schema": {
              "title": "Workspace Gid",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AsanaProjectsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Asana Projects",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/asana/workspaces": {
      "get": {
        "description": "Get user's Asana workspaces",
        "operationId": "get_asana_workspaces_v1_task_integrations_asana_workspaces_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AsanaWorkspacesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Asana Workspaces",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/clickup/lists/{space_id}": {
      "get": {
        "description": "Get lists in a ClickUp space",
        "operationId": "get_clickup_lists_v1_task_integrations_clickup_lists__space_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "space_id",
            "required": true,
            "schema": {
              "title": "Space Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClickUpListsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Clickup Lists",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/clickup/spaces/{team_id}": {
      "get": {
        "description": "Get spaces in a ClickUp team",
        "operationId": "get_clickup_spaces_v1_task_integrations_clickup_spaces__team_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "team_id",
            "required": true,
            "schema": {
              "title": "Team Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClickUpSpacesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Clickup Spaces",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/clickup/teams": {
      "get": {
        "description": "Get user's ClickUp teams",
        "operationId": "get_clickup_teams_v1_task_integrations_clickup_teams_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ClickUpTeamsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Clickup Teams",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/default": {
      "get": {
        "description": "Get the user's default task integration app.",
        "operationId": "get_default_task_integration_v1_task_integrations_default_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DefaultTaskIntegrationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Default Task Integration",
        "tags": [
          "task-integrations"
        ]
      },
      "put": {
        "description": "Set the user's default task integration app.",
        "operationId": "set_default_task_integration_v1_task_integrations_default_put",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DefaultTaskIntegrationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DefaultTaskIntegrationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Default Task Integration",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/{app_key}": {
      "delete": {
        "description": "Delete a task integration connection.",
        "operationId": "delete_task_integration_v1_task_integrations__app_key__delete",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Task Integration",
        "tags": [
          "task-integrations"
        ]
      },
      "put": {
        "description": "Save or update a task integration connection.",
        "operationId": "save_task_integration_v1_task_integrations__app_key__put",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskIntegrationData"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskIntegrationMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Save Task Integration",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/{app_key}/oauth-url": {
      "get": {
        "description": "Get OAuth authorization URL for a task integration.\nFrontend opens this URL in browser to start OAuth flow.\nUses secure random state tokens to prevent CSRF attacks.",
        "operationId": "get_oauth_url_v1_task_integrations__app_key__oauth_url_get",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthUrlResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Oauth Url",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-integrations/{app_key}/tasks": {
      "post": {
        "description": "Create a task in the specified integration using stored credentials.",
        "operationId": "create_task_via_integration_v1_task_integrations__app_key__tasks_post",
        "parameters": [
          {
            "in": "path",
            "name": "app_key",
            "required": true,
            "schema": {
              "title": "App Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTaskRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateTaskResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Task Via Integration",
        "tags": [
          "task-integrations"
        ]
      }
    },
    "/v1/task-intelligence/context-snapshot": {
      "put": {
        "operationId": "replace_context_snapshot_v1_task_intelligence_context_snapshot_put",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 512,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/NormalizedContextSnapshot"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SnapshotReceipt"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Replace Context Snapshot",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/task-intelligence/debug/evaluations/{evaluation_id}": {
      "get": {
        "operationId": "get_evaluation_debug_projection_v1_task_intelligence_debug_evaluations__evaluation_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "evaluation_id",
            "required": true,
            "schema": {
              "title": "Evaluation Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "device_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Device Id"
            }
          },
          {
            "in": "header",
            "name": "X-Omi-Debug",
            "required": false,
            "schema": {
              "default": false,
              "title": "X-Omi-Debug",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DecisionDebugProjection"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Evaluation Debug Projection",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/task-intelligence/feedback": {
      "post": {
        "operationId": "create_feedback_v1_task_intelligence_feedback_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 512,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/FeedbackCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FeedbackRecord"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Feedback",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/task-intelligence/interventions": {
      "post": {
        "operationId": "register_intervention_v1_task_intelligence_interventions_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 512,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/InterventionCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InterventionRecord"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Register Intervention",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/task-intelligence/open-loop-snapshot": {
      "put": {
        "operationId": "replace_open_loop_snapshot_v1_task_intelligence_open_loop_snapshot_put",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 512,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OpenLoopSnapshot"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SnapshotReceipt"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Replace Open Loop Snapshot",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/task-intelligence/outcomes": {
      "post": {
        "operationId": "create_outcome_v1_task_intelligence_outcomes_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 512,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OutcomeCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OutcomeRecord"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Outcome",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/users/ai-profile": {
      "get": {
        "operationId": "get_ai_profile_v1_users_ai_profile_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "anyOf": [
                    {
                      "$ref": "#/components/schemas/AIUserProfileResponse"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "title": "Response Get Ai Profile V1 Users Ai Profile Get"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Ai Profile",
        "tags": [
          "users"
        ]
      },
      "patch": {
        "operationId": "update_ai_profile_v1_users_ai_profile_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAIUserProfileRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AIUserProfileResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Ai Profile",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/analytics/chat_message": {
      "post": {
        "description": "Submit feedback rating for a chat message.\n\nArgs:\n    message_id: ID of the message being rated\n    value: Rating value (1 = thumbs up, -1 = thumbs down, 0 = neutral/removed)\n    reason: Optional reason for thumbs down. Valid values:\n        - 'too_verbose': Response was too long or wordy\n        - 'incorrect_or_hallucination': Response contained incorrect information\n        - 'not_helpful_or_irrelevant': Response didn't address the question\n        - 'didnt_follow_instructions': Response didn't follow user instructions\n        - 'other': Other reason",
        "operationId": "set_chat_message_analytics_v1_users_analytics_chat_message_post",
        "parameters": [
          {
            "in": "query",
            "name": "message_id",
            "required": true,
            "schema": {
              "title": "Message Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "reason",
            "required": false,
            "schema": {
              "title": "Reason",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Chat Message Analytics",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/analytics/memory_summary": {
      "get": {
        "operationId": "get_memory_summary_rating_v1_users_analytics_memory_summary_get",
        "parameters": [
          {
            "in": "query",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemorySummaryRatingResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Memory Summary Rating",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "set_memory_summary_rating_v1_users_analytics_memory_summary_post",
        "parameters": [
          {
            "in": "query",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Memory Summary Rating",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/assistant-settings": {
      "get": {
        "operationId": "get_assistant_settings_v1_users_assistant_settings_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssistantSettingsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Assistant Settings",
        "tags": [
          "users"
        ]
      },
      "patch": {
        "operationId": "update_assistant_settings_v1_users_assistant_settings_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAssistantSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AssistantSettingsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Assistant Settings",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/daily-summaries": {
      "get": {
        "description": "Get list of daily summaries for the authenticated user.\nReturns summaries in reverse chronological order.",
        "operationId": "get_daily_summaries_v1_users_daily_summaries_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DailySummariesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Daily Summaries",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/daily-summaries/{summary_id}": {
      "delete": {
        "description": "Delete a daily summary by ID.",
        "operationId": "delete_daily_summary_v1_users_daily_summaries__summary_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "summary_id",
            "required": true,
            "schema": {
              "title": "Summary Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Daily Summary",
        "tags": [
          "v1"
        ]
      },
      "get": {
        "description": "Get a single daily summary by ID.",
        "operationId": "get_daily_summary_v1_users_daily_summaries__summary_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "summary_id",
            "required": true,
            "schema": {
              "title": "Summary Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DailySummaryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Daily Summary",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/daily-summaries/{summary_id}/regenerate": {
      "post": {
        "description": "Re-run summary generation for the date of an existing daily summary and\noverwrite the same doc in place. No push notification — the user is\nalready looking at the page.",
        "operationId": "regenerate_daily_summary_v1_users_daily_summaries__summary_id__regenerate_post",
        "parameters": [
          {
            "in": "path",
            "name": "summary_id",
            "required": true,
            "schema": {
              "title": "Summary Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DailySummaryResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Regenerate Daily Summary",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/daily-summaries/{summary_id}/visibility": {
      "patch": {
        "description": "Set the visibility of a daily summary. Use value='shared' to make it shareable.",
        "operationId": "set_daily_summary_visibility_v1_users_daily_summaries__summary_id__visibility_patch",
        "parameters": [
          {
            "in": "path",
            "name": "summary_id",
            "required": true,
            "schema": {
              "title": "Summary Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Daily Summary Visibility",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/daily-summary-settings": {
      "get": {
        "description": "Get user's daily summary notification settings.\n\nReturns:\n    - enabled: Whether daily summary notifications are enabled (default: True)\n    - hour: Preferred hour in user's local timezone (0-23, default: 22 for 10 PM)",
        "operationId": "get_daily_summary_settings_v1_users_daily_summary_settings_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DailySummarySettingsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Daily Summary Settings",
        "tags": [
          "v1"
        ]
      },
      "patch": {
        "description": "Update user's daily summary notification settings.\n\nParameters:\n    - enabled: Enable/disable daily summary notifications\n    - hour: Preferred hour in local timezone (0-23).\n            Examples: 22 (10 PM), 8 (8 AM), 18 (6 PM)\n\nNote: Hour is stored as local time. The system determines when to send\nbased on the user's timezone and will send the summary at the correct local time",
        "operationId": "update_daily_summary_settings_v1_users_daily_summary_settings_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DailySummarySettingsUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Daily Summary Settings",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/daily-summary-settings/test": {
      "post": {
        "description": "Test endpoint to manually trigger daily summary for the authenticated user.\nThis bypasses the time check and sends a summary immediately.\nOptionally accepts a date parameter (YYYY-MM-DD) to generate summary for a specific date.",
        "operationId": "test_daily_summary_v1_users_daily_summary_settings_test_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TestDailySummaryRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DailySummaryTestResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Test Daily Summary",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/delete-account": {
      "delete": {
        "operationId": "delete_account_v1_users_delete_account_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteAccountRequest",
                "default": {}
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Account",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/developer/webhook/{wtype}": {
      "get": {
        "operationId": "get_user_webhook_endpoint_v1_users_developer_webhook__wtype__get",
        "parameters": [
          {
            "in": "path",
            "name": "wtype",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookType"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserWebhookUrlResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Webhook Endpoint",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "set_user_webhook_endpoint_v1_users_developer_webhook__wtype__post",
        "parameters": [
          {
            "in": "path",
            "name": "wtype",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookType"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetUserWebhookUrlRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set User Webhook Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/developer/webhook/{wtype}/disable": {
      "post": {
        "operationId": "disable_user_webhook_endpoint_v1_users_developer_webhook__wtype__disable_post",
        "parameters": [
          {
            "in": "path",
            "name": "wtype",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookType"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Disable User Webhook Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/developer/webhook/{wtype}/enable": {
      "post": {
        "operationId": "enable_user_webhook_endpoint_v1_users_developer_webhook__wtype__enable_post",
        "parameters": [
          {
            "in": "path",
            "name": "wtype",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/WebhookType"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Enable User Webhook Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/developer/webhooks/status": {
      "get": {
        "operationId": "get_user_webhooks_status_v1_users_developer_webhooks_status_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserWebhooksStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Webhooks Status",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/export": {
      "get": {
        "description": "Export all user data for GDPR/CCPA compliance. Streams response to avoid timeouts.",
        "operationId": "export_all_user_data_v1_users_export_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserDataExportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Export All User Data",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/fcm-token": {
      "post": {
        "operationId": "save_token_v1_users_fcm_token_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveFcmTokenRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FcmTokenResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Save Token"
      }
    },
    "/v1/users/geolocation": {
      "patch": {
        "operationId": "set_user_geolocation_v1_users_geolocation_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Geolocation"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set User Geolocation",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/language": {
      "get": {
        "description": "Get the user's preferred language.",
        "operationId": "get_user_language_v1_users_language_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserLanguageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Language",
        "tags": [
          "v1"
        ]
      },
      "patch": {
        "description": "Set the user's preferred language (e.g., 'en', 'vi', etc.).",
        "operationId": "set_user_language_v1_users_language_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetUserLanguageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserLanguageUpdateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set User Language",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/me/byok-active": {
      "delete": {
        "description": "Drop the user off the BYOK free plan (keys were cleared client-side).",
        "operationId": "deactivate_byok_endpoint_v1_users_me_byok_active_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BYOKActiveResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Deactivate Byok Endpoint",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "description": "Flip the user onto the BYOK free plan.\n\nThe client sends SHA-256 fingerprints of the 4 provider keys so we can\ndetect rotation without ever seeing the keys. The live keys themselves\ntravel on every request as headers; they are never persisted.",
        "operationId": "activate_byok_endpoint_v1_users_me_byok_active_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BYOKActivateRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BYOKActiveResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Activate Byok Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/me/llm-usage": {
      "get": {
        "description": "Get LLM token usage summary for the current user.\n\nReturns usage breakdown by feature for the specified time period.",
        "operationId": "get_llm_usage_v1_users_me_llm_usage_get",
        "parameters": [
          {
            "in": "query",
            "name": "days",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 365,
              "minimum": 1,
              "title": "Days",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LlmUsageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Llm Usage",
        "tags": [
          "users"
        ]
      },
      "post": {
        "operationId": "record_llm_usage_bucket_v1_users_me_llm_usage_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RecordLlmUsageBucketRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LlmUsageRecordResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Record Llm Usage Bucket",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/me/llm-usage/top-features": {
      "get": {
        "description": "Get top features by LLM token usage for the current user.\n\nReturns the top N features sorted by total token consumption.",
        "operationId": "get_llm_top_features_v1_users_me_llm_usage_top_features_get",
        "parameters": [
          {
            "in": "query",
            "name": "days",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 365,
              "minimum": 1,
              "title": "Days",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 3,
              "maximum": 10,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/LlmUsageFeatureResponse"
                  },
                  "title": "Response Get Llm Top Features V1 Users Me Llm Usage Top Features Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Llm Top Features",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/me/llm-usage/total": {
      "get": {
        "operationId": "get_total_llm_cost_v1_users_me_llm_usage_total_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LlmTotalCostResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Total Llm Cost",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/me/paywall": {
      "get": {
        "description": "Trial-paywall status for the calling user on the given platform.\n\nUsed by the Rust desktop-backend middleware to decide whether to proxy\npaid LLM / TTS / Pinecone traffic. Mirrors the exact semantics of\n`is_trial_paywalled`: basic plan + no active BYOK + Firebase Auth\naccount >3d old + platform in {macos, desktop}. Mobile platforms always\nreturn `paywalled=false`.\n\nPlatform comes from `X-App-Platform` header (preferred) or `platform`\nquery param (fallback). Unknown / missing platforms are never paywalled.",
        "operationId": "get_user_paywall_status_v1_users_me_paywall_get",
        "parameters": [
          {
            "in": "query",
            "name": "platform",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Platform"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaywallStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Paywall Status",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/me/subscription": {
      "get": {
        "description": "Gets the user's subscription plan and usage.",
        "operationId": "get_user_subscription_endpoint_v1_users_me_subscription_get",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserSubscriptionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Subscription Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/me/trial": {
      "get": {
        "description": "Structured trial metadata for the calling user.\n\nReturns trial timing info (start, end, remaining seconds, expired flag)\nplus the list of features available during trial and the plan the user\nfalls to after trial expiry. Used by desktop clients to render countdown\nbanners and pre-expiry upgrade nudges.\n\nPaid-plan and BYOK users get `trial_expired=False` with zeroed timing\n(trial is irrelevant to them — they have full access).",
        "operationId": "get_user_trial_status_v1_users_me_trial_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialMetadata"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Trial Status",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/me/usage": {
      "get": {
        "description": "Gets daily and monthly usage stats for the authenticated user.",
        "operationId": "get_user_usage_stats_endpoint_v1_users_me_usage_get",
        "parameters": [
          {
            "in": "query",
            "name": "period",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/UsagePeriod",
              "default": "today"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserUsageResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Usage Stats Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/me/usage-quota": {
      "get": {
        "description": "Current-month chat usage for the user, plus their plan's cap.\n\nUsed by the desktop app. Mobile uses the subscription endpoint instead.",
        "operationId": "get_user_chat_usage_quota_v1_users_me_usage_quota_get",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatUsageQuota"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Chat Usage Quota",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/mentor-notification-settings": {
      "get": {
        "description": "Get user's mentor notification frequency preference.\n\nReturns:\n    - frequency: Notification frequency (0-5)\n      - 0 = disabled\n      - 1 = ultra selective (least frequent)\n      - 3 = balanced (default)\n      - 5 = very proactive (most frequent)",
        "operationId": "get_mentor_notification_settings_v1_users_mentor_notification_settings_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MentorNotificationSettingsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Mentor Notification Settings",
        "tags": [
          "v1"
        ]
      },
      "patch": {
        "description": "Update user's mentor notification frequency preference.\n\nParameters:\n    - frequency: Notification frequency (0-5)\n      - 0 = disabled\n      - 1 = ultra selective (least frequent)\n      - 3 = balanced (default)\n      - 5 = very proactive (most frequent)",
        "operationId": "update_mentor_notification_settings_v1_users_mentor_notification_settings_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MentorNotificationSettingsUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Mentor Notification Settings",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/migration/batch-requests": {
      "post": {
        "description": "Migrates a batch of data objects to the target protection level.",
        "operationId": "handle_batch_migration_requests_v1_users_migration_batch_requests_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BatchMigrationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MigrationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Handle Batch Migration Requests",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/migration/requests": {
      "get": {
        "description": "Checks which documents need to be migrated to the target level.",
        "operationId": "get_migration_requests_v1_users_migration_requests_get",
        "parameters": [
          {
            "in": "query",
            "name": "target_level",
            "required": true,
            "schema": {
              "title": "Target Level",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MigrationRequestsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Migration Requests",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "description": "Handles data migration requests.\n- If 'id' and 'type' are present, it migrates a single object.\n- Otherwise, it initiates the data migration process for a 'target_level'.",
        "operationId": "handle_migration_requests_v1_users_migration_requests_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/MigrationRequest"
                  },
                  {
                    "$ref": "#/components/schemas/MigrationTargetRequest"
                  }
                ],
                "title": "Request"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MigrationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Handle Migration Requests",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/migration/requests/data-protection-level/finalize": {
      "post": {
        "description": "Finalizes the migration by setting the user's global protection level.",
        "operationId": "finalize_migration_request_v1_users_migration_requests_data_protection_level_finalize_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/MigrationTargetRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MigrationStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Finalize Migration Request",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/notification-settings": {
      "get": {
        "operationId": "get_notification_settings_v1_users_notification_settings_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationSettingsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Notification Settings",
        "tags": [
          "users"
        ]
      },
      "patch": {
        "operationId": "update_notification_settings_v1_users_notification_settings_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateNotificationSettingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NotificationSettingsResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Notification Settings",
        "tags": [
          "users"
        ]
      }
    },
    "/v1/users/onboarding": {
      "get": {
        "description": "Get the user's onboarding state (completed status, acquisition source, etc.).",
        "operationId": "get_onboarding_state_v1_users_onboarding_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OnboardingStateResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Onboarding State",
        "tags": [
          "v1"
        ]
      },
      "patch": {
        "description": "Update the user's onboarding state.",
        "operationId": "update_onboarding_state_v1_users_onboarding_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OnboardingStateUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Onboarding State",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/people": {
      "get": {
        "operationId": "get_all_people_v1_users_people_get",
        "parameters": [
          {
            "in": "query",
            "name": "include_speech_samples",
            "required": false,
            "schema": {
              "default": true,
              "title": "Include Speech Samples",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Person"
                  },
                  "title": "Response Get All People V1 Users People Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get All People",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "description": "Create a new person or return existing one with same name (idempotent by name).\n\nThis enables backward compatibility: old apps can call this API and get the\nsame person that backend already created, preventing duplicates.",
        "operationId": "get_or_create_person_v1_users_people_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreatePerson"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Person"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Or Create Person",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/people/{person_id}": {
      "delete": {
        "operationId": "delete_person_endpoint_v1_users_people__person_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "person_id",
            "required": true,
            "schema": {
              "title": "Person Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Person Endpoint",
        "tags": [
          "v1"
        ]
      },
      "get": {
        "operationId": "get_single_person_v1_users_people__person_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "person_id",
            "required": true,
            "schema": {
              "title": "Person Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "include_speech_samples",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Speech Samples",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Person"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Single Person",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/people/{person_id}/name": {
      "patch": {
        "operationId": "update_person_name_v1_users_people__person_id__name_patch",
        "parameters": [
          {
            "in": "path",
            "name": "person_id",
            "required": true,
            "schema": {
              "title": "Person Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Person Name",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/people/{person_id}/speech-samples/{sample_index}": {
      "delete": {
        "description": "Delete a specific speech sample for a person by index.",
        "operationId": "delete_person_speech_sample_endpoint_v1_users_people__person_id__speech_samples__sample_index__delete",
        "parameters": [
          {
            "in": "path",
            "name": "person_id",
            "required": true,
            "schema": {
              "title": "Person Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "sample_index",
            "required": true,
            "schema": {
              "title": "Sample Index",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Person Speech Sample Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/preferences/app": {
      "put": {
        "description": "Sets the user's preferred app for future processing.",
        "operationId": "set_preferred_app_for_user_v1_users_preferences_app_put",
        "parameters": [
          {
            "description": "The ID of the app to set as preferred",
            "in": "query",
            "name": "app_id",
            "required": true,
            "schema": {
              "description": "The ID of the app to set as preferred",
              "title": "App Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Preferred App For User",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/private-cloud-sync": {
      "get": {
        "operationId": "get_private_cloud_sync_v1_users_private_cloud_sync_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PrivateCloudSyncResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Private Cloud Sync",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "set_private_cloud_sync_v1_users_private_cloud_sync_post",
        "parameters": [
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Private Cloud Sync",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/profile": {
      "get": {
        "description": "Gets the full user profile, including data protection and migration status.",
        "operationId": "get_user_profile_endpoint_v1_users_profile_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserProfileResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get User Profile Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/stats/chat-messages": {
      "get": {
        "description": "Get total count of chat messages for the user.",
        "operationId": "get_chat_message_count_v1_users_stats_chat_messages_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatMessageCountResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Chat Message Count",
        "tags": [
          "chat-sessions"
        ]
      }
    },
    "/v1/users/store-recording-permission": {
      "delete": {
        "operationId": "delete_permission_and_recordings_v1_users_store_recording_permission_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Permission And Recordings",
        "tags": [
          "v1"
        ]
      },
      "get": {
        "operationId": "get_store_recording_permission_v1_users_store_recording_permission_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreRecordingPermissionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Store Recording Permission",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "operationId": "store_recording_permission_v1_users_store_recording_permission_post",
        "parameters": [
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Store Recording Permission",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/training-data-opt-in": {
      "get": {
        "description": "Get the user's training data opt-in status.",
        "operationId": "get_training_data_opt_in_status_v1_users_training_data_opt_in_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrainingDataOptInResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Training Data Opt In Status",
        "tags": [
          "v1"
        ]
      },
      "post": {
        "description": "Opt-in for training data program. User's request will be reviewed.",
        "operationId": "set_training_data_opt_in_status_v1_users_training_data_opt_in_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Set Training Data Opt In Status",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/users/transcription-preferences": {
      "get": {
        "description": "Get user's transcription preferences (single language mode, vocabulary).",
        "operationId": "get_transcription_preferences_endpoint_v1_users_transcription_preferences_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranscriptionPreferencesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Transcription Preferences Endpoint",
        "tags": [
          "v1"
        ]
      },
      "patch": {
        "description": "Update user's transcription preferences.\n\n- single_language_mode: If True, uses exact language for higher accuracy but disables translation\n- vocabulary: List of custom keywords/terms (max 100) for better transcription accuracy",
        "operationId": "update_transcription_preferences_endpoint_v1_users_transcription_preferences_patch",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TranscriptionPreferencesUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Transcription Preferences Endpoint",
        "tags": [
          "v1"
        ]
      }
    },
    "/v1/what-matters-now": {
      "get": {
        "operationId": "get_what_matters_now_v1_what_matters_now_get",
        "parameters": [
          {
            "in": "query",
            "name": "device_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Device Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhatMattersNowProjection"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get What Matters Now",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/what-matters-now/evaluate": {
      "post": {
        "operationId": "evaluate_what_matters_now_v1_what_matters_now_evaluate_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EvaluationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhatMattersNowProjection"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Evaluate What Matters Now",
        "tags": [
          "task-intelligence"
        ]
      }
    },
    "/v1/work-intents": {
      "post": {
        "description": "Idempotent backend operation behind the “Work on this with Omi” affordance.",
        "operationId": "resolve_work_intent_v1_work_intents_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "discriminator": {
                  "mapping": {
                    "goal": "#/components/schemas/GoalOriginWorkIntent",
                    "task": "#/components/schemas/TaskOriginWorkIntent"
                  },
                  "propertyName": "origin"
                },
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/TaskOriginWorkIntent"
                  },
                  {
                    "$ref": "#/components/schemas/GoalOriginWorkIntent"
                  }
                ],
                "title": "Request"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkIntentReceipt"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Resolve Work Intent",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workflow-migrations/task-goal-links": {
      "post": {
        "operationId": "import_task_goal_links_v1_workflow_migrations_task_goal_links_post",
        "parameters": [
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TaskGoalLinkImportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TaskGoalLinkImportReport"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Import Task Goal Links",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workstreams/{workstream_id}": {
      "get": {
        "operationId": "get_workstream_detail_v1_workstreams__workstream_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkstreamDetailProjection"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Workstream Detail",
        "tags": [
          "tasks"
        ]
      },
      "patch": {
        "operationId": "update_workstream_v1_workstreams__workstream_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkstreamUpdate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Workstream"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Workstream",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workstreams/{workstream_id}/artifacts": {
      "get": {
        "operationId": "list_artifact_descriptors_v1_workstreams__workstream_id__artifacts_get",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ArtifactDescriptor"
                  },
                  "title": "Response List Artifact Descriptors V1 Workstreams  Workstream Id  Artifacts Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Artifact Descriptors",
        "tags": [
          "tasks"
        ]
      },
      "post": {
        "operationId": "create_artifact_descriptor_v1_workstreams__workstream_id__artifacts_post",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArtifactDescriptorCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArtifactDescriptor"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Artifact Descriptor",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workstreams/{workstream_id}/artifacts/{artifact_id}/status": {
      "patch": {
        "operationId": "transition_artifact_status_v1_workstreams__workstream_id__artifacts__artifact_id__status_patch",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "artifact_id",
            "required": true,
            "schema": {
              "title": "Artifact Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ArtifactStatusTransitionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArtifactDescriptor"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Transition Artifact Status",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workstreams/{workstream_id}/checkpoints": {
      "get": {
        "operationId": "list_continuation_checkpoints_v1_workstreams__workstream_id__checkpoints_get",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/ContinuationCheckpoint"
                  },
                  "title": "Response List Continuation Checkpoints V1 Workstreams  Workstream Id  Checkpoints Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Continuation Checkpoints",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workstreams/{workstream_id}/checkpoints/{runtime_id}": {
      "put": {
        "operationId": "upsert_continuation_checkpoint_v1_workstreams__workstream_id__checkpoints__runtime_id__put",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "runtime_id",
            "required": true,
            "schema": {
              "title": "Runtime Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ContinuationCheckpointUpsert"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContinuationCheckpoint"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Upsert Continuation Checkpoint",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/workstreams/{workstream_id}/events": {
      "get": {
        "operationId": "list_workstream_events_v1_workstreams__workstream_id__events_get",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "after_sequence",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "After Sequence",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/WorkstreamEvent"
                  },
                  "title": "Response List Workstream Events V1 Workstreams  Workstream Id  Events Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Workstream Events",
        "tags": [
          "tasks"
        ]
      },
      "post": {
        "operationId": "append_workstream_event_v1_workstreams__workstream_id__events_post",
        "parameters": [
          {
            "in": "path",
            "name": "workstream_id",
            "required": true,
            "schema": {
              "title": "Workstream Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Idempotency-Key",
            "required": true,
            "schema": {
              "maxLength": 256,
              "minLength": 1,
              "title": "Idempotency-Key",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Account-Generation",
            "required": true,
            "schema": {
              "minimum": 0,
              "title": "X-Account-Generation",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/WorkstreamEventCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkstreamEvent"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Append Workstream Event",
        "tags": [
          "tasks"
        ]
      }
    },
    "/v1/wrapped/{year}": {
      "get": {
        "description": "Get the status and result of wrapped generation for a given year.\n\nReturns:\n    - status: not_generated, processing, done, or error\n    - result: The wrapped payload (only when status=done)\n    - error: Error message (only when status=error)\n    - progress: Progress info (only when status=processing)",
        "operationId": "get_wrapped_status_v1_wrapped__year__get",
        "parameters": [
          {
            "in": "path",
            "name": "year",
            "required": true,
            "schema": {
              "title": "Year",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WrappedStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Wrapped Status",
        "tags": [
          "wrapped"
        ]
      }
    },
    "/v1/wrapped/{year}/generate": {
      "post": {
        "description": "Start wrapped generation for a given year.\n\nThis is idempotent:\n- If already done: returns done status (no regeneration in v1)\n- If already processing: returns processing status\n- If error or not generated: starts generation\n- If processing but stuck (no heartbeat for 15 min): restarts generation",
        "operationId": "generate_wrapped_v1_wrapped__year__generate_post",
        "parameters": [
          {
            "in": "path",
            "name": "year",
            "required": true,
            "schema": {
              "title": "Year",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GenerateWrappedResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Generate Wrapped",
        "tags": [
          "wrapped"
        ]
      }
    },
    "/v2/apps": {
      "get": {
        "description": "Public omi apps, paginated by capability groups.\n\nNotes:\n- Uses approved public apps only (no private/tester apps).\n- Groups: Popular, Integrations, Chat Assistants, Summary Apps, Realtime Notifications.\n- Popular section is shown first.\n- Always excludes persona type apps.",
        "operationId": "get_apps_v2_v2_apps_get",
        "parameters": [
          {
            "description": "Filter by capability id",
            "in": "query",
            "name": "capability",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by capability id",
              "title": "Capability"
            }
          },
          {
            "description": "Filter by category id",
            "in": "query",
            "name": "category",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by category id",
              "title": "Category"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "include_reviews",
            "required": false,
            "schema": {
              "default": false,
              "title": "Include Reviews",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppCatalogResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Apps V2",
        "tags": [
          "v2"
        ]
      }
    },
    "/v2/apps/capability/{capability_id}/grouped": {
      "get": {
        "description": "Get all apps for a specific capability, grouped by master category.\n\nReturns apps grouped into master categories like:\n- For chat: Personality Clones, Productivity & Lifestyle, Social & Entertainment\n- For others: Productivity & Tools, Personal & Lifestyle, Social & Entertainment",
        "operationId": "get_capability_apps_grouped_by_category_v2_apps_capability__capability_id__grouped_get",
        "parameters": [
          {
            "in": "path",
            "name": "capability_id",
            "required": true,
            "schema": {
              "title": "Capability Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "include_reviews",
            "required": false,
            "schema": {
              "default": true,
              "title": "Include Reviews",
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppCatalogResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Capability Apps Grouped By Category",
        "tags": [
          "v2"
        ]
      }
    },
    "/v2/apps/search": {
      "get": {
        "description": "Search and filter apps with pagination.\n\nReturns a flat list of apps matching the search and filter criteria.",
        "operationId": "search_apps_v2_apps_search_get",
        "parameters": [
          {
            "description": "Search query for app name or description",
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Search query for app name or description",
              "title": "Q"
            }
          },
          {
            "description": "Filter by category id",
            "in": "query",
            "name": "category",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by category id",
              "title": "Category"
            }
          },
          {
            "description": "Minimum rating filter",
            "in": "query",
            "name": "rating",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maximum": 5,
                  "minimum": 0,
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Minimum rating filter",
              "title": "Rating"
            }
          },
          {
            "description": "Filter by capability id",
            "in": "query",
            "name": "capability",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter by capability id",
              "title": "Capability"
            }
          },
          {
            "description": "Sort order: installs, rating_asc, rating_desc, name_asc, name_desc",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Sort order: installs, rating_asc, rating_desc, name_asc, name_desc",
              "title": "Sort"
            }
          },
          {
            "description": "Filter to show only user's apps",
            "in": "query",
            "name": "my_apps",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter to show only user's apps",
              "title": "My Apps"
            }
          },
          {
            "description": "Filter to show only installed/enabled apps",
            "in": "query",
            "name": "installed_apps",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Filter to show only installed/enabled apps",
              "title": "Installed Apps"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "minimum": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AppSearchResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Search Apps",
        "tags": [
          "v2"
        ]
      }
    },
    "/v2/files": {
      "post": {
        "operationId": "upload_file_chat_v2_files_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_file_chat_v2_files_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/FileChat"
                  },
                  "title": "Response Upload File Chat V2 Files Post",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Upload File Chat",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/firmware/latest": {
      "get": {
        "operationId": "get_latest_version_v2_firmware_latest_get",
        "parameters": [
          {
            "in": "query",
            "name": "device_model",
            "required": true,
            "schema": {
              "title": "Device Model",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "firmware_revision",
            "required": true,
            "schema": {
              "title": "Firmware Revision",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "hardware_revision",
            "required": true,
            "schema": {
              "title": "Hardware Revision",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "manufacturer_name",
            "required": true,
            "schema": {
              "title": "Manufacturer Name",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirmwareVersionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Latest Version"
      }
    },
    "/v2/firmware/stable": {
      "get": {
        "description": "Return the latest stable firmware for a device, regardless of current version.\n\nUsed for rolling back to the official stable firmware after flashing custom firmware.",
        "operationId": "get_stable_version_v2_firmware_stable_get",
        "parameters": [
          {
            "in": "query",
            "name": "device_model",
            "required": true,
            "schema": {
              "title": "Device Model",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirmwareVersionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Stable Version"
      }
    },
    "/v2/firmware/version": {
      "get": {
        "description": "Return the OTA metadata for a specific published firmware version of a device.\n\nComplements /v2/firmware/stable by making any individual published build addressable, e.g. to pin\nor roll a device back to a known-good earlier version, or for QA/support to flash a named build.",
        "operationId": "get_firmware_version_v2_firmware_version_get",
        "parameters": [
          {
            "in": "query",
            "name": "device_model",
            "required": true,
            "schema": {
              "title": "Device Model",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "version",
            "required": true,
            "schema": {
              "title": "Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FirmwareVersionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Firmware Version"
      }
    },
    "/v2/initial-message": {
      "post": {
        "operationId": "create_initial_message_v2_initial_message_post",
        "parameters": [
          {
            "in": "query",
            "name": "app_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "App Id"
            }
          },
          {
            "in": "query",
            "name": "plugin_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Plugin Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Initial Message",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/messages": {
      "delete": {
        "operationId": "clear_chat_messages_v2_messages_delete",
        "parameters": [
          {
            "in": "query",
            "name": "app_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "App Id"
            }
          },
          {
            "in": "query",
            "name": "plugin_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Plugin Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Message"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Clear Chat Messages",
        "tags": [
          "chat"
        ]
      },
      "get": {
        "operationId": "get_messages_v2_messages_get",
        "parameters": [
          {
            "in": "query",
            "name": "plugin_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Plugin Id"
            }
          },
          {
            "in": "query",
            "name": "app_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "App Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/Message"
                  },
                  "title": "Response Get Messages V2 Messages Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Messages",
        "tags": [
          "chat"
        ]
      },
      "post": {
        "operationId": "send_message_v2_messages_post",
        "parameters": [
          {
            "in": "query",
            "name": "plugin_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Plugin Id"
            }
          },
          {
            "in": "query",
            "name": "app_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "App Id"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SendMessageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResponseMessage"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Send Message",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/messages/share": {
      "post": {
        "description": "Create a shareable link for chat messages.",
        "operationId": "share_chat_messages_v2_messages_share_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ShareChatMessagesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShareChatMessagesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Share Chat Messages",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/messages/shared/{token}": {
      "get": {
        "description": "Public endpoint — get shared chat messages (no auth required).",
        "operationId": "get_shared_chat_messages_v2_messages_shared__token__get",
        "parameters": [
          {
            "in": "path",
            "name": "token",
            "required": true,
            "schema": {
              "title": "Token",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SharedChatMessagesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [],
        "summary": "Get Shared Chat Messages",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/messages/{message_id}/rating": {
      "patch": {
        "description": "Rate a chat message (thumbs up/down). Used by desktop client.",
        "operationId": "rate_message_v2_messages__message_id__rating_patch",
        "parameters": [
          {
            "in": "path",
            "name": "message_id",
            "required": true,
            "schema": {
              "title": "Message Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RateMessageRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChatRatingResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Rate Message",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/messages/{message_id}/report": {
      "post": {
        "operationId": "report_message_v2_messages__message_id__report_post",
        "parameters": [
          {
            "in": "path",
            "name": "message_id",
            "required": true,
            "schema": {
              "title": "Message Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MessageReportResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Report Message",
        "tags": [
          "chat"
        ]
      }
    },
    "/v2/sync-capture-manifest": {
      "post": {
        "operationId": "create_sync_capture_manifest_v2_sync_capture_manifest_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SyncCaptureManifestRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SyncCaptureManifestResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Sync Capture Manifest"
      }
    },
    "/v2/sync-local-files": {
      "post": {
        "description": "Async version of sync-local-files. Saves raw files and returns 202\nimmediately, then runs the full pipeline (decode → VAD → STT → LLM) as\nan async background task. The app polls GET /v2/sync-local-files/{job_id}.",
        "operationId": "sync_local_files_v2_v2_sync_local_files_post",
        "parameters": [
          {
            "description": "Target conversation ID to attach audio to (auto-sync from live capture)",
            "in": "query",
            "name": "conversation_id",
            "required": false,
            "schema": {
              "description": "Target conversation ID to attach audio to (auto-sync from live capture)",
              "title": "Conversation Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Request-ID",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Request-Id"
            }
          },
          {
            "in": "header",
            "name": "X-Cloud-Trace-Context",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Cloud-Trace-Context"
            }
          },
          {
            "in": "header",
            "name": "X-Omi-Sync-Capture-Manifest",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "X-Omi-Sync-Capture-Manifest"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_sync_local_files_v2_v2_sync_local_files_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SyncJobStartResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Sync Local Files V2"
      }
    },
    "/v2/sync-local-files/{job_id}": {
      "get": {
        "description": "Poll for the status of an async sync job.",
        "operationId": "get_sync_job_status_v2_sync_local_files__job_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "job_id",
            "required": true,
            "schema": {
              "title": "Job Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SyncJobStatusResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Sync Job Status"
      }
    },
    "/v2/tts/synthesize": {
      "post": {
        "description": "Proxy a TTS request to ElevenLabs. Per-user rate limited.",
        "operationId": "tts_synthesize_v2_tts_synthesize_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/TtsSynthesizeRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "audio/mpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "MP3 audio stream."
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Tts Synthesize",
        "tags": [
          "tts"
        ]
      }
    },
    "/v2/voice-message/transcribe": {
      "post": {
        "description": "Transcribe audio and return the transcript text.\n\nAccepts two content types:\n- multipart/form-data: file upload with optional 'language' form field (mobile)\n- application/octet-stream: raw PCM bytes with query params (desktop PTT)\n\nReturns {\"transcript\": \"...\", \"language\": \"...\"}.",
        "operationId": "transcribe_voice_message_v2_voice_message_transcribe_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoiceMessageTranscriptionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranscriptionErrorResponse"
                }
              }
            },
            "description": "Invalid audio input"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          },
          "502": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranscriptionErrorResponse"
                }
              }
            },
            "description": "Upstream or unexpected-empty result"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranscriptionErrorResponse"
                }
              }
            },
            "description": "Provider configuration unavailable"
          },
          "504": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TranscriptionErrorResponse"
                }
              }
            },
            "description": "Provider timeout"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Transcribe Voice Message"
      }
    },
    "/v2/voice-messages": {
      "post": {
        "operationId": "create_voice_message_stream_v2_voice_messages_post",
        "parameters": [
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_create_voice_message_stream_v2_voice_messages_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Server-sent event stream of chat message chunks."
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Voice Message Stream"
      }
    },
    "/v3/memories": {
      "delete": {
        "operationId": "delete_memories_v3_memories_delete",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Memories",
        "tags": [
          "memories"
        ]
      },
      "get": {
        "operationId": "get_memories_v3_memories_get",
        "parameters": [
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": 0,
              "title": "Offset",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "cursor",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "in": "query",
            "name": "device_scope",
            "required": false,
            "schema": {
              "default": "all",
              "title": "Device Scope",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "client_device_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Client Device Id"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "$ref": "#/components/schemas/MemoryDB"
                  },
                  "title": "Response Get Memories V3 Memories Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Memories",
        "tags": [
          "memories"
        ]
      },
      "post": {
        "operationId": "create_memory_v3_memories_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Memory"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryDB"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Memory",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/batch": {
      "post": {
        "operationId": "create_memories_batch_v3_memories_batch_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/routers__memories__BatchMemoriesRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/routers__memories__BatchMemoriesResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Create Memories Batch",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/review-queue": {
      "get": {
        "operationId": "list_memory_review_queue_v3_memories_review_queue_get",
        "parameters": [
          {
            "in": "query",
            "name": "status",
            "required": false,
            "schema": {
              "default": "pending",
              "title": "Status",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "limit",
            "required": false,
            "schema": {
              "default": 100,
              "maximum": 500,
              "minimum": 1,
              "title": "Limit",
              "type": "integer"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "additionalProperties": true,
                    "type": "object"
                  },
                  "title": "Response List Memory Review Queue V3 Memories Review Queue Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "List Memory Review Queue",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/review-queue/{review_id}": {
      "get": {
        "description": "Fetch a single memory review conflict by id.\n\nThe list endpoint only returns conflicts in the 'pending' status, so once a conflict is\nresolved it can no longer be retrieved. This fetches any of the user's review conflicts\nby id regardless of status, returning 404 if it does not exist.",
        "operationId": "get_memory_review_item_v3_memories_review_queue__review_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "review_id",
            "required": true,
            "schema": {
              "title": "Review Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryReviewItemResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Memory Review Item",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/review-queue/{review_id}/resolve": {
      "post": {
        "operationId": "resolve_memory_review_item_v3_memories_review_queue__review_id__resolve_post",
        "parameters": [
          {
            "in": "path",
            "name": "review_id",
            "required": true,
            "schema": {
              "title": "Review Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviewResolutionRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReviewResolutionResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Resolve Memory Review Item",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/{memory_id}": {
      "delete": {
        "operationId": "delete_memory_v3_memories__memory_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Memory",
        "tags": [
          "memories"
        ]
      },
      "patch": {
        "operationId": "edit_memory_v3_memories__memory_id__patch",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "deprecated": true,
            "description": "Deprecated; send JSON body {'value': ...} instead",
            "in": "query",
            "name": "value",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "deprecated": true,
              "description": "Deprecated; send JSON body {'value': ...} instead",
              "title": "Value"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/MemoryValueRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Request"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Edit Memory",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/{memory_id}/review": {
      "post": {
        "operationId": "review_memory_v3_memories__memory_id__review_post",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "value",
            "required": true,
            "schema": {
              "title": "Value",
              "type": "boolean"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Review Memory",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/memories/{memory_id}/visibility": {
      "patch": {
        "operationId": "update_memory_visibility_v3_memories__memory_id__visibility_patch",
        "parameters": [
          {
            "in": "path",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "deprecated": true,
            "description": "Deprecated; send JSON body {'value': ...} instead",
            "in": "query",
            "name": "value",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "deprecated": true,
              "description": "Deprecated; send JSON body {'value': ...} instead",
              "title": "Value"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "anyOf": [
                  {
                    "$ref": "#/components/schemas/MemoryValueRequest"
                  },
                  {
                    "type": "null"
                  }
                ],
                "title": "Request"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MemoryMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "404": {
            "$ref": "#/components/responses/Error404"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Update Memory Visibility",
        "tags": [
          "memories"
        ]
      }
    },
    "/v3/speech-profile": {
      "get": {
        "operationId": "has_speech_profile_v3_speech_profile_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HasSpeechProfileResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Has Speech Profile",
        "tags": [
          "v3"
        ]
      }
    },
    "/v3/speech-profile/expand": {
      "delete": {
        "operationId": "delete_extra_speech_profile_sample_v3_speech_profile_expand_delete",
        "parameters": [
          {
            "in": "query",
            "name": "memory_id",
            "required": true,
            "schema": {
              "title": "Memory Id",
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "segment_idx",
            "required": true,
            "schema": {
              "title": "Segment Idx",
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "person_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Person Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SpeechProfileMutationResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Delete Extra Speech Profile Sample",
        "tags": [
          "v3"
        ]
      },
      "get": {
        "operationId": "get_extra_speech_profile_samples_v3_speech_profile_expand_get",
        "parameters": [
          {
            "in": "query",
            "name": "person_id",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Person Id"
            }
          },
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "items": {
                    "type": "string"
                  },
                  "title": "Response Get Extra Speech Profile Samples V3 Speech Profile Expand Get",
                  "type": "array"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Extra Speech Profile Samples",
        "tags": [
          "v3"
        ]
      }
    },
    "/v3/upload-audio": {
      "post": {
        "operationId": "upload_profile_v3_upload_audio_post",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/Body_upload_profile_v3_upload_audio_post"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SpeechProfileUploadResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Upload Profile",
        "tags": [
          "v3"
        ]
      }
    },
    "/v4/speech-profile": {
      "get": {
        "operationId": "get_speech_profile_v4_speech_profile_get",
        "parameters": [
          {
            "in": "header",
            "name": "authorization",
            "required": false,
            "schema": {
              "title": "Authorization",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Platform",
            "required": false,
            "schema": {
              "title": "X-App-Platform",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-Device-Id-Hash",
            "required": false,
            "schema": {
              "title": "X-Device-Id-Hash",
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "X-App-Version",
            "required": false,
            "schema": {
              "title": "X-App-Version",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SpeechProfileResponse"
                }
              }
            },
            "description": "Successful Response"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPValidationError"
                }
              }
            },
            "description": "Validation Error"
          }
        },
        "security": [
          {
            "firebaseBearer": []
          }
        ],
        "summary": "Get Speech Profile",
        "tags": [
          "v3"
        ]
      }
    }
  },
  "servers": [
    {
      "description": "Production",
      "url": "https://api.omi.me"
    }
  ],
  "tags": [
    {
      "description": "Read and write user memories - timeless facts, preferences, and insights.",
      "name": "Memories"
    },
    {
      "description": "Create and retrieve conversation transcripts with AI-generated summaries.",
      "name": "Conversations"
    },
    {
      "description": "Retrieve user-defined folders for organizing conversations.",
      "name": "Folders"
    },
    {
      "description": "Manage tasks and to-dos extracted from conversations or created manually.",
      "name": "Action Items"
    },
    {
      "description": "Manage user goals and progress history.",
      "name": "Goals"
    },
    {
      "description": "Create, list, and revoke developer API keys.",
      "name": "API Keys"
    }
  ]
}