@leaflow/sdk 0.0.0-dev.101.g01ce843

package/dist/support/v1/schema.d.ts

@@ -0,0 +1,1078 @@
+/**
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
+ */
+export interface paths {
+    "/api/v1/notices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the maintenance in effect right now
+         * @description Returns the maintenance windows that have not finished yet.
+         *
+         *     **This operation requires no credentials.** It is intended for sign-in pages and status
+         *     pages, which are reached before a project has been selected. It returns a narrower shape
+         *     than the authenticated operations and is not paginated.
+         *
+         *     Platform announcements are not part of this API. They are served by the notification
+         *     service, which owns platform-wide announcements.
+         */
+        get: operations["list-notices"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tickets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List tickets in the current project
+         * @description Ordered by most recent activity first, which is not the same as most recently opened.
+         */
+        get: operations["list-tickets"];
+        put?: never;
+        /**
+         * Open a ticket
+         * @description Opens a ticket and posts its first message in one request. A ticket always has at least one
+         *     message.
+         *
+         *     The new ticket is `OPEN`. Its `number` is assigned here and is the identifier to quote when
+         *     contacting support by other means.
+         *
+         *     `category_id` is optional. Submitting a category that has been disabled returns
+         *     `TICKET_CATEGORY_DISABLED`; the categories accepting new tickets are those returned by
+         *     `GET /api/v1/ticket-categories`.
+         */
+        post: operations["create-ticket"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tickets/{ticketId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a ticket
+         * @description Returns 404 for a ticket that belongs to another project.
+         */
+        get: operations["get-ticket"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tickets/{ticketId}/close": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Close a ticket
+         * @description Closing a ticket that is already closed succeeds and changes nothing.
+         *
+         *     A closed ticket can be rated once; see `POST /api/v1/tickets/{ticketId}/satisfaction`.
+         *     Posting a further message reopens it.
+         */
+        post: operations["close-ticket"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tickets/{ticketId}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the messages on a ticket
+         * @description Ordered oldest first, because a ticket is a conversation.
+         */
+        get: operations["list-ticket-messages"];
+        put?: never;
+        /**
+         * Post a message on a ticket
+         * @description Moves the ticket to `OPEN`. Posting on a closed ticket reopens it.
+         *
+         *     Each id in `attachment_ids` must name an attachment uploaded in this project that no other
+         *     message references; otherwise the request fails with `TICKET_ATTACHMENT_ALREADY_ATTACHED`
+         *     and no message is posted.
+         */
+        post: operations["create-ticket-message"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/tickets/{ticketId}/satisfaction": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get the rating submitted for a ticket */
+        get: operations["get-ticket-satisfaction"];
+        put?: never;
+        /**
+         * Rate a ticket
+         * @description The ticket must be closed; otherwise the request returns `TICKET_NOT_CLOSED`.
+         *
+         *     A ticket can be rated once. A second submission returns
+         *     `TICKET_SATISFACTION_ALREADY_SUBMITTED`, including after the ticket has been reopened and
+         *     closed again.
+         */
+        post: operations["create-ticket-satisfaction"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/ticket-categories": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the categories accepting new tickets
+         * @description Ordered for presentation. Categories no longer accepting new tickets are omitted, including those still attached to existing tickets.
+         */
+        get: operations["list-ticket-categories"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/attachments": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Upload an attachment
+         * @description The body is the file bytes themselves, not multipart, one file per request. The content type
+         *     is determined from the content, not from the `Content-Type` header.
+         *
+         *     Pass the returned id in `attachment_ids` when opening a ticket or posting a message. An
+         *     attachment that is never referenced by a message is removed after a time.
+         */
+        post: operations["upload-attachment"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/attachments/{attachmentId}/content": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Download an attachment
+         * @description Serves the file itself. The bytes are proxied by this API; the object store is not reachable
+         *     from outside, and no address to it is ever handed out.
+         *
+         *     `Content-Type` is the type determined from the content at upload time, not the one the
+         *     client claimed. `Content-Disposition` is `attachment` unless `inline` is requested **and**
+         *     the content type is one that can be rendered safely, in which case it is `inline`. Asking
+         *     for `inline` on anything else still yields a download.
+         */
+        get: operations["download-attachment"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/maintenances": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List maintenance notices
+         * @description Ordered by scheduled start, most recent first. Cancelled maintenance is omitted.
+         *
+         *     `scheduled_for` and `scheduled_until` are what was announced; `started_at` and
+         *     `completed_at` are what actually happened, and are null until it does.
+         */
+        get: operations["list-maintenances"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/maintenances/{maintenanceId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Get a maintenance notice
+         * @description Returns 404 for cancelled maintenance.
+         */
+        get: operations["get-maintenance"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/api/v1/maintenances/{maintenanceId}/timeline": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the updates posted during a maintenance
+         * @description Ordered oldest first, because it is an account of what happened.
+         */
+        get: operations["list-maintenance-timeline"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+export type webhooks = Record<string, never>;
+export interface components {
+    schemas: {
+        Error: {
+            code?: string;
+            message: string;
+            meta?: {
+                [key: string]: unknown;
+            };
+            /** Format: int64 */
+            status: number;
+        };
+        /**
+         * @description `OPEN` is waiting on us. `AWAITING_USER` is waiting on you. `CLOSED` is finished.
+         *
+         *     The state follows whoever spoke last and cannot be set directly.
+         * @enum {string}
+         */
+        TicketStatus: "OPEN" | "AWAITING_USER" | "CLOSED";
+        /**
+         * @description How urgent the ticket is. It affects the order support works through tickets; it is not a commitment to a response time.
+         * @enum {string}
+         */
+        TicketPriority: "LOW" | "NORMAL" | "HIGH" | "URGENT";
+        /**
+         * @description Whether a message was written by a project member or by support.
+         * @enum {string}
+         */
+        TicketAuthorType: "USER" | "OPERATOR";
+        /**
+         * @description `SCHEDULED` has been announced but has not started. `IN_PROGRESS` is under way. `COMPLETED`
+         *     has finished. `CANCELLED` was announced and then called off, and never took place.
+         * @enum {string}
+         */
+        MaintenanceStatus: "SCHEDULED" | "IN_PROGRESS" | "COMPLETED" | "CANCELLED";
+        /**
+         * @description What users should expect during the window.
+         * @enum {string}
+         */
+        MaintenanceImpact: "NONE" | "DEGRADED" | "PARTIAL_OUTAGE" | "MAJOR_OUTAGE";
+        /** @description A support ticket, owned by the project it was opened in. */
+        TicketResource: {
+            /** @description The category this ticket is in; null when it has none */
+            category: components["schemas"]["TicketCategoryResource"] | null;
+            /**
+             * Format: date-time
+             * @description When the ticket was closed; null while it is open
+             */
+            closed_at: string | null;
+            /** Format: date-time */
+            created_at: string;
+            /** @description The user who opened the ticket. Every member of the project can read and reply to it regardless */
+            created_by: string;
+            /** Format: uuid */
+            id: string;
+            /**
+             * Format: date-time
+             * @description When someone last spoke on this ticket. Changing the priority or the category does not affect it
+             */
+            last_activity_at: string;
+            /** @description The human-readable identifier to quote when contacting support by other means */
+            number: string;
+            priority: components["schemas"]["TicketPriority"];
+            /** @description The rating submitted for this ticket; null when it has not been rated */
+            satisfaction: components["schemas"]["TicketSatisfactionResource"] | null;
+            status: components["schemas"]["TicketStatus"];
+            subject: string;
+            /** Format: date-time */
+            updated_at: string;
+        };
+        /** @description A ticket category. */
+        TicketCategoryResource: {
+            description: string | null;
+            /** Format: uuid */
+            id: string;
+            name: string;
+        };
+        /** @description One message on a ticket. */
+        TicketMessageResource: {
+            attachments: components["schemas"]["TicketAttachmentResource"][];
+            /** @description The identifier of whoever wrote the message, interpreted according to author_type */
+            author_id: string;
+            author_type: components["schemas"]["TicketAuthorType"];
+            body: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: uuid */
+            id: string;
+        };
+        /** @description A file uploaded for a ticket. The bytes are retrieved separately; see the download-url operation. */
+        TicketAttachmentResource: {
+            /** @description Determined from the content, which may differ from the Content-Type sent on upload */
+            content_type: string;
+            /** Format: date-time */
+            created_at: string;
+            filename: string;
+            /** Format: uuid */
+            id: string;
+            /** Format: int64 */
+            size_bytes: number;
+        };
+        /** @description The rating submitted for a ticket. */
+        TicketSatisfactionResource: {
+            comment: string | null;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: uuid */
+            id: string;
+            /** Format: int64 */
+            score: number;
+        };
+        /** @description A scheduled maintenance notice published by platform operators. */
+        MaintenanceResource: {
+            /** @description Markdown */
+            body: string;
+            /**
+             * Format: date-time
+             * @description When the maintenance actually finished; null until it does
+             */
+            completed_at: string | null;
+            /** @description What this maintenance affects. The names are those used by the services concerned */
+            components: string[];
+            /** Format: uuid */
+            id: string;
+            impact: components["schemas"]["MaintenanceImpact"];
+            /**
+             * Format: date-time
+             * @description The announced start
+             */
+            scheduled_for: string;
+            /**
+             * Format: date-time
+             * @description The announced end
+             */
+            scheduled_until: string;
+            /**
+             * Format: date-time
+             * @description When the maintenance actually started; null until it does
+             */
+            started_at: string | null;
+            status: components["schemas"]["MaintenanceStatus"];
+            title: string;
+        };
+        /** @description One update posted during a maintenance. */
+        MaintenanceTimelineEntryResource: {
+            body: string;
+            /** Format: date-time */
+            created_at: string;
+            /** Format: uuid */
+            id: string;
+            /** @description The impact this update declared; null when the update did not change it */
+            impact: components["schemas"]["MaintenanceImpact"] | null;
+            /** @description The state this update moved the maintenance to; null when the update did not change it */
+            status: components["schemas"]["MaintenanceStatus"] | null;
+        };
+        /**
+         * @description What is in effect right now, for readers who have not signed in.
+         *
+         *     This shape is deliberately narrower than the authenticated resources and carries no read
+         *     state.
+         */
+        NoticeResource: {
+            maintenances: components["schemas"]["NoticeMaintenanceResource"][];
+        };
+        NoticeMaintenanceResource: {
+            /** @description Markdown */
+            body: string;
+            components: string[];
+            /** Format: uuid */
+            id: string;
+            impact: components["schemas"]["MaintenanceImpact"];
+            /** Format: date-time */
+            scheduled_for: string;
+            /** Format: date-time */
+            scheduled_until: string;
+            /** Format: date-time */
+            started_at: string | null;
+            status: components["schemas"]["MaintenanceStatus"];
+            title: string;
+        };
+        CreateTicketRequestBody: {
+            /** @description Attachments to reference from the first message. Each must have been uploaded in this project and not yet referenced */
+            attachment_ids?: string[];
+            /** @description The first message. Markdown */
+            body: string;
+            /** Format: uuid */
+            category_id?: string;
+            priority?: components["schemas"]["TicketPriority"];
+            subject: string;
+        };
+        CreateTicketMessageRequestBody: {
+            /** @description Attachments to reference. Each must have been uploaded in this project and not yet referenced */
+            attachment_ids?: string[];
+            /** @description Markdown */
+            body: string;
+        };
+        CreateTicketSatisfactionRequestBody: {
+            comment?: string;
+            /** Format: int64 */
+            score: number;
+        };
+        LengthAwarePageTicketResource: {
+            /** @description The contents of this page */
+            items: components["schemas"]["TicketResource"][];
+            /**
+             * Format: int64
+             * @description Maximum items per page, echoing the value in the request
+             */
+            limit: number;
+            /**
+             * Format: int64
+             * @description Items skipped, echoing the value in the request
+             */
+            offset: number;
+            /**
+             * Format: int64
+             * @description Total number of matching items, not only those in this page
+             */
+            total: number;
+        };
+        LengthAwarePageTicketMessageResource: {
+            /** @description The contents of this page */
+            items: components["schemas"]["TicketMessageResource"][];
+            /** Format: int64 */
+            limit: number;
+            /** Format: int64 */
+            offset: number;
+            /** Format: int64 */
+            total: number;
+        };
+        LengthAwarePageTicketCategoryResource: {
+            /** @description The contents of this page */
+            items: components["schemas"]["TicketCategoryResource"][];
+            /** Format: int64 */
+            limit: number;
+            /** Format: int64 */
+            offset: number;
+            /** Format: int64 */
+            total: number;
+        };
+        LengthAwarePageMaintenanceResource: {
+            /** @description The contents of this page */
+            items: components["schemas"]["MaintenanceResource"][];
+            /** Format: int64 */
+            limit: number;
+            /** Format: int64 */
+            offset: number;
+            /** Format: int64 */
+            total: number;
+        };
+        LengthAwarePageMaintenanceTimelineEntryResource: {
+            /** @description The contents of this page */
+            items: components["schemas"]["MaintenanceTimelineEntryResource"][];
+            /** Format: int64 */
+            limit: number;
+            /** Format: int64 */
+            offset: number;
+            /** Format: int64 */
+            total: number;
+        };
+    };
+    responses: never;
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+export type $defs = Record<string, never>;
+export interface operations {
+    "list-notices": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["NoticeResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-tickets": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return in this page */
+                limit?: number;
+                /** @description Number of items to skip */
+                offset?: number;
+                /** @description Return only tickets in this state; omit for all states */
+                status?: components["schemas"]["TicketStatus"];
+                /** @description Return only tickets at this priority; omit for all priorities */
+                priority?: components["schemas"]["TicketPriority"];
+                /** @description Return only tickets in this category; omit for all categories */
+                category_id?: string;
+                /** @description Match against the subject and the ticket number, case-insensitively */
+                keyword?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageTicketResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-ticket": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateTicketRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-ticket": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "close-ticket": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-ticket-messages": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return in this page */
+                limit?: number;
+                /** @description Number of items to skip */
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                ticketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageTicketMessageResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-ticket-message": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateTicketMessageRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketMessageResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-ticket-satisfaction": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketSatisfactionResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "create-ticket-satisfaction": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                ticketId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateTicketSatisfactionRequestBody"];
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketSatisfactionResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-ticket-categories": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return in this page */
+                limit?: number;
+                /** @description Number of items to skip */
+                offset?: number;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageTicketCategoryResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "upload-attachment": {
+        parameters: {
+            query: {
+                /** @description The file name to record, and the name the file is served under when downloaded */
+                filename: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/octet-stream": string;
+            };
+        };
+        responses: {
+            /** @description Created */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["TicketAttachmentResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "download-attachment": {
+        parameters: {
+            query?: {
+                /** @description Render in the browser instead of downloading, where the content type allows it */
+                inline?: boolean;
+            };
+            header?: never;
+            path: {
+                attachmentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    /** @description `inline` when the content type can be rendered safely and `inline` was asked for, `attachment` otherwise. Carries the original file name */
+                    "Content-Disposition"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "*/*": string;
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-maintenances": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return in this page */
+                limit?: number;
+                /** @description Number of items to skip */
+                offset?: number;
+                /** @description Return only maintenance in this state; omit for all states */
+                status?: components["schemas"]["MaintenanceStatus"];
+                /** @description Return only maintenance affecting this component; omit for all components */
+                component?: string;
+            };
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageMaintenanceResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "get-maintenance": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                maintenanceId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["MaintenanceResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+    "list-maintenance-timeline": {
+        parameters: {
+            query?: {
+                /** @description Maximum number of items to return in this page */
+                limit?: number;
+                /** @description Number of items to skip */
+                offset?: number;
+            };
+            header?: never;
+            path: {
+                maintenanceId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description OK */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LengthAwarePageMaintenanceTimelineEntryResource"];
+                };
+            };
+            /** @description Error */
+            default: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["Error"];
+                };
+            };
+        };
+    };
+}