openapi: 3.1.0 info: title: Generated OpenAPI specification from proto file version: v1.0.0 paths: /api/v1/items: get: operationId: getItems parameters: - name: limit in: query required: true schema: type: integer format: int32 - name: offset in: query required: true schema: type: integer format: int32 responses: "200": $ref: '#/components/responses/GetItemsResponse' post: operationId: createItem requestBody: $ref: '#/components/requestBodies/CreateItemRequest' responses: "200": $ref: '#/components/responses/Item' /api/v1/items/{id}: get: operationId: getItem parameters: - name: id in: path required: true schema: type: string responses: "200": $ref: '#/components/responses/Item' put: operationId: updateItem parameters: - name: id in: path required: true schema: type: string requestBody: $ref: '#/components/requestBodies/UpdateItemRequest' responses: "200": $ref: '#/components/responses/Item' delete: operationId: deleteItem parameters: - name: id in: path required: true schema: type: string responses: "200": $ref: '#/components/responses/Empty' patch: operationId: patchItem parameters: - name: id in: path required: true schema: type: string requestBody: $ref: '#/components/requestBodies/PatchItemRequest' responses: "200": $ref: '#/components/responses/Item' components: schemas: Item: type: object properties: id: type: string type: $ref: '#/components/schemas/Type' name: type: string createdAt: type: string format: date-time required: - id - type - name - createdAt Type: type: string enum: - ITEM_TYPE_UNSPECIFIED - ITEM_TYPE_BASIC responses: Empty: description: Empty content: application/json: schema: type: object GetItemsResponse: description: GetItemsResponse content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/Item' totalCount: type: integer format: int32 required: - items - totalCount Item: description: Item content: application/json: schema: type: object properties: id: type: string type: $ref: '#/components/schemas/Type' name: type: string createdAt: type: string format: date-time required: - id - type - name - createdAt requestBodies: CreateItemRequest: content: application/json: schema: type: object properties: name: type: string required: - name PatchItemRequest: content: application/json: schema: type: object properties: type: $ref: '#/components/schemas/Type' name: type: string UpdateItemRequest: content: application/json: schema: type: object properties: type: $ref: '#/components/schemas/Type' name: type: string required: - type - name