Incus warnings API

The warnings API from Incus — 3 operation(s) for warnings.

Operations 6

GET /1.0/warnings List the warnings #
DELETE /1.0/warnings/{uuid} Delete the warning #
GET /1.0/warnings/{uuid} Get the warning #
PATCH /1.0/warnings/{uuid} Partially update the warning #
PUT /1.0/warnings/{uuid} Update the warning #
GET /1.0/warnings?recursion=1 Get the warnings #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/incus-warnings-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

incus-warnings-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  contact:
    email: lxc-devel@lists.linuxcontainers.org
    name: Incus upstream
    url: https://github.com/lxc/incus
  description: 'This is the REST API used by all Incus clients.

    Internal endpoints aren''t included in this documentation.


    The Incus API is available over both a local unix+http and remote https API.

    Authentication for local users relies on group membership and access to the unix socket.

    For remote users, the default authentication method is TLS client

    certificates.'
  license:
    name: Apache-2.0
    url: https://www.apache.org/licenses/LICENSE-2.0
  title: Incus external REST certificates Warnings API
  version: '1.0'
tags:
- name: warnings
paths:
  /1.0/warnings:
    get:
      description: Returns a list of warnings.
      operationId: warnings_get
      parameters:
      - description: Project name
        example: default
        in: query
        name: project
        schema:
          type: string
      responses:
        '200':
          description: Sync response
          content:
            application/json:
              schema:
                description: Sync response
                properties:
                  metadata:
                    description: List of endpoints
                    example: "[\n  \"/1.0/warnings/39c61a48-cc17-40ae-8248-4f7b4cadedf4\",\n  \"/1.0/warnings/951779a5-2820-4d96-b01e-88fe820e5310\"\n]"
                    items:
                      type: string
                    type: array
                  status:
                    description: Status description
                    example: Success
                    type: string
                  status_code:
                    description: Status code
                    example: 200
                    type: integer
                  type:
                    description: Response type
                    example: sync
                    type: string
                type: object
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: List the warnings
      tags:
      - warnings
  /1.0/warnings/{uuid}:
    delete:
      description: Removes the warning.
      operationId: warning_delete
      parameters:
      - description: UUID
        in: path
        name: uuid
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/EmptySyncResponse'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Delete the warning
      tags:
      - warnings
    get:
      description: Gets a specific warning.
      operationId: warning_get
      parameters:
      - description: UUID
        in: path
        name: uuid
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Warning
          content:
            application/json:
              schema:
                description: Sync response
                properties:
                  metadata:
                    $ref: '#/components/schemas/Warning'
                  status:
                    description: Status description
                    example: Success
                    type: string
                  status_code:
                    description: Status code
                    example: 200
                    type: integer
                  type:
                    description: Response type
                    example: sync
                    type: string
                type: object
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Get the warning
      tags:
      - warnings
    patch:
      description: Updates a subset of the warning status.
      operationId: warning_patch
      parameters:
      - description: UUID
        in: path
        name: uuid
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/EmptySyncResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Partially update the warning
      tags:
      - warnings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WarningPut'
        description: Warning status
        required: true
    put:
      description: Updates the warning status.
      operationId: warning_put
      parameters:
      - description: UUID
        in: path
        name: uuid
        required: true
        schema:
          type: string
      responses:
        '200':
          $ref: '#/components/responses/EmptySyncResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Update the warning
      tags:
      - warnings
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WarningPut'
        description: Warning status
        required: true
  /1.0/warnings?recursion=1:
    get:
      description: Returns a list of warnings (structs).
      operationId: warnings_get_recursion1
      parameters:
      - description: Project name
        example: default
        in: query
        name: project
        schema:
          type: string
      responses:
        '200':
          description: API endpoints
          content:
            application/json:
              schema:
                description: Sync response
                properties:
                  metadata:
                    description: List of warnings
                    items:
                      $ref: '#/components/schemas/Warning'
                    type: array
                  status:
                    description: Status description
                    example: Success
                    type: string
                  status_code:
                    description: Status code
                    example: 200
                    type: integer
                  type:
                    description: Response type
                    example: sync
                    type: string
                type: object
        '500':
          $ref: '#/components/responses/InternalServerError'
      summary: Get the warnings
      tags:
      - warnings
components:
  responses:
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            properties:
              error:
                example: not authorized
                type: string
                x-go-name: Error
              error_code:
                example: 403
                format: int64
                type: integer
                x-go-name: ErrorCode
              type:
                example: error
                type: string
                x-go-name: Type
            type: object
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            properties:
              error:
                example: internal server error
                type: string
                x-go-name: Error
              error_code:
                example: 500
                format: int64
                type: integer
                x-go-name: ErrorCode
              type:
                example: error
                type: string
                x-go-name: Type
            type: object
    BadRequest:
      description: Bad Request
      content:
        application/json:
          schema:
            properties:
              error:
                example: bad request
                type: string
                x-go-name: Error
              error_code:
                example: 400
                format: int64
                type: integer
                x-go-name: ErrorCode
              type:
                example: error
                type: string
                x-go-name: Type
            type: object
    NotFound:
      description: Not found
      content:
        application/json:
          schema:
            properties:
              error:
                example: not found
                type: string
                x-go-name: Error
              error_code:
                example: 404
                format: int64
                type: integer
                x-go-name: ErrorCode
              type:
                example: error
                type: string
                x-go-name: Type
            type: object
    EmptySyncResponse:
      description: Empty sync response
      content:
        application/json:
          schema:
            properties:
              status:
                example: Success
                type: string
                x-go-name: Status
              status_code:
                example: 200
                format: int64
                type: integer
                x-go-name: StatusCode
              type:
                example: sync
                type: string
                x-go-name: Type
            type: object
  schemas:
    Warning:
      properties:
        count:
          description: The number of times this warning occurred
          example: 1
          format: int64
          type: integer
          x-go-name: Count
        entity_url:
          description: The entity affected by this warning
          example: /1.0/instances/c1?project=default
          type: string
          x-go-name: EntityURL
        first_seen_at:
          description: The first time this warning occurred
          example: '2021-03-23T17:38:37.753398689-04:00'
          format: date-time
          type: string
          x-go-name: FirstSeenAt
        last_message:
          description: The warning message
          example: Couldn't find the CGroup blkio.weight, disk priority will be ignored
          type: string
          x-go-name: LastMessage
        last_seen_at:
          description: The last time this warning occurred
          example: '2021-03-23T17:38:37.753398689-04:00'
          format: date-time
          type: string
          x-go-name: LastSeenAt
        location:
          description: What cluster member this warning occurred on
          example: server01
          type: string
          x-go-name: Location
        project:
          description: The project the warning occurred in
          example: default
          type: string
          x-go-name: Project
        severity:
          description: The severity of this warning
          example: low
          type: string
          x-go-name: Severity
        status:
          description: Status of the warning (new, acknowledged, or resolved)
          example: new
          type: string
          x-go-name: Status
        type:
          description: Type type of warning
          example: Couldn't find CGroup
          type: string
          x-go-name: Type
        uuid:
          description: UUID of the warning
          example: e9e9da0d-2538-4351-8047-46d4a8ae4dbb
          type: string
          x-go-name: UUID
      title: Warning represents a warning entry.
      type: object
      x-go-package: github.com/lxc/incus/v7/shared/api
    WarningPut:
      properties:
        status:
          description: Status of the warning (new, acknowledged, or resolved)
          example: new
          type: string
          x-go-name: Status
      title: WarningPut represents the modifiable fields of a warning.
      type: object
      x-go-package: github.com/lxc/incus/v7/shared/api