openapi: 3.0.1
info:
    title: SID Plugin
    description: A plugin for the SID framework.
    version: "v1"
servers:
    - url: https://api.sid.ai/v1
paths:
    /users/me/query:
        post:
            operationId: query
            summary: Query the user's connected integrations for data
            requestBody:
                required: true
                content:
                    application/json:
                        schema:
                            $ref: "#/components/schemas/queryRequest"
            responses:
                "200":
                    description: OK
                    content:
                        application/json:
                            schema:
                                $ref: "#/components/schemas/queryResponse"
components:
    schemas:
        queryRequest:
            type: object
            required:
                - query
            properties:
                query:
                    type: string
                    description: The natural language query to search for.
                    required: true
                limit:
                    type: integer
                    description: The maximum number of results to return.
                    required: false
        queryResponse:
            type: object
            properties:
                results:
                    type: array
                    items:
                        type: object
                        properties:
                            text:
                                type: string
                                description: The text of this match
                            score:
                                type: number
                                description: The score of this match. Higher is better.
                            name:
                                type: string
                                description: The name of the document this match is from
                            kind:
                                type: string
                                description: The kind of the document this match is from
                    description: The list of results