paths:
  summary: "Interact with all entities within a namespace"
  get:
    description: "Get names and IDs of all entities"
    tags:
    - entities
    parameters:
    - $ref: "#/components/parameters/token"
    responses:
      200:
        $ref: "#/components/schemas/responseShortList"

  post:
    description: "Create a new entity"
    tags:
    - entities
    parameters:
    - $ref: "#/components/parameters/token"
    requestBody:
      $ref: "#/components/schemas/requestOne"
    responses:
      200:
        $ref: "#/components/schemas/responseOne"

components:
  parameters:
    token:
      $ref: "../swagger.yaml#/components/parameters/token"
  schemas:
    requestOne:
      $ref: "../swagger.yaml#/components/schemas/requestOne"
    responseOne:
      $ref: "../swagger.yaml#/components/schemas/responseOne"
    responseShortList:
      $ref: "../swagger.yaml#/components/schemas/responseShortList"