[DON'T MERGE - FOR TESTING] Update API Documentation for Artifacts

[epamLDadayan]

Changes Made:

1. Removed references to integration_id and is_local parameters.
2. Introduced configuration_title parameter in relevant endpoints.
3. Removed all references to AdminAPI mode handlers.
4. Deleted documentation related to the api/v1/storage.py file.

Summary:

This update aligns the API documentation with the latest backend changes, ensuring consistency and clarity for developers.

[Copilot]

Pull Request Overview

This pull request updates the API documentation by adding comprehensive Artifacts endpoints documentation and aligning with recent backend changes. The update removes outdated parameters and references while introducing new API endpoints for bucket and file management.

• Added complete API documentation for Artifacts endpoints including bucket listing, bucket details, and file upload operations
• Removed references to deprecated integration_id, is_local parameters and AdminAPI mode handlers
• Introduced configuration_title parameter support in relevant endpoints

[Copilot]

The content type should be specified in the responses section. For OpenAPI 3.0, use 'content' under responses, but this appears to be using OpenAPI 2.0 format based on the basePath. Consider using 'produces' at the operation level or switching to OpenAPI 3.0 format consistently.

Suggested change

	responses:
	'200':
	description: A list of buckets.
	content:
	application/json:
	schema:
	type: array
	items:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the bucket.
	name:
	type: string
	description: The name of the bucket.
	produces:
	- application/json
	responses:
	'200':
	description: A list of buckets.
	schema:
	type: array
	items:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the bucket.
	name:
	type: string
	description: The name of the bucket.

[Copilot]

Same issue as above - mixing OpenAPI 2.0 and 3.0 syntax. The 'content' keyword is from OpenAPI 3.0 but the document uses 'basePath' which is OpenAPI 2.0.

Suggested change

	content:
	application/json:
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the bucket.
	name:
	type: string
	description: The name of the bucket.
	created_at:
	type: string
	format: date-time
	description: The creation timestamp of the bucket.
	/artifacts/files:
	post:
	summary: Upload a file
	description: Upload a new file to a bucket.
	requestBody:
	required: true
	content:
	multipart/form-data:
	schema:
	type: object
	properties:
	bucket_id:
	type: string
	description: The ID of the bucket to upload the file to.
	file:
	type: string
	format: binary
	description: The file to upload.
	responses:
	'201':
	description: File uploaded successfully.
	content:
	application/json:
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the uploaded file.
	name:
	type: string
	description: The name of the uploaded file.
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the bucket.
	name:
	type: string
	description: The name of the bucket.
	created_at:
	type: string
	format: date-time
	description: The creation timestamp of the bucket.
	/artifacts/files:
	post:
	summary: Upload a file
	description: Upload a new file to a bucket.
	consumes:
	- multipart/form-data
	parameters:
	- name: bucket_id
	in: formData
	required: true
	type: string
	description: The ID of the bucket to upload the file to.
	- name: file
	in: formData
	required: true
	type: file
	description: The file to upload.
	responses:
	'201':
	description: File uploaded successfully.
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the uploaded file.
	name:
	type: string
	description: The name of the uploaded file.

[Copilot]

Inconsistent OpenAPI version usage - 'content' is OpenAPI 3.0 syntax while the document appears to follow OpenAPI 2.0 format based on 'basePath' usage.

Suggested change

	content:
	application/json:
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the bucket.
	name:
	type: string
	description: The name of the bucket.
	created_at:
	type: string
	format: date-time
	description: The creation timestamp of the bucket.
	/artifacts/files:
	post:
	summary: Upload a file
	description: Upload a new file to a bucket.
	requestBody:
	required: true
	content:
	multipart/form-data:
	schema:
	type: object
	properties:
	bucket_id:
	type: string
	description: The ID of the bucket to upload the file to.
	file:
	type: string
	format: binary
	description: The file to upload.
	responses:
	'201':
	description: File uploaded successfully.
	content:
	application/json:
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the uploaded file.
	name:
	type: string
	description: The name of the uploaded file.
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the bucket.
	name:
	type: string
	description: The name of the bucket.
	created_at:
	type: string
	format: date-time
	description: The creation timestamp of the bucket.
	/artifacts/files:
	post:
	summary: Upload a file
	description: Upload a new file to a bucket.
	parameters:
	- name: body
	in: body
	required: true
	schema:
	type: object
	properties:
	bucket_id:
	type: string
	description: The ID of the bucket to upload the file to.
	file:
	type: string
	format: binary
	description: The file to upload.
	responses:
	'201':
	description: File uploaded successfully.
	schema:
	type: object
	properties:
	id:
	type: string
	description: The unique identifier for the uploaded file.
	name:
	type: string
	description: The name of the uploaded file.

[Copilot]

Missing error response documentation. File upload operations should include error responses for common scenarios like invalid bucket_id (404), file too large (413), or server errors (500).

[Copilot]

Missing required fields specification. The schema should indicate which properties are required, particularly 'bucket_id' and 'file' for the upload operation.

Suggested change

	type: object
	type: object
	required:
	- bucket_id
	- file