Files
medusa-store/www/apps/api-reference/specs/admin/paths/admin_uploads.yaml
Shahed Nasser 7d650771d1 docs: generate medusa-react reference (#6004)
* add new plugin for better organization

* added handling in theme for mutations and query types

* added tsdoc to hooks

* added tsdocs to utility functions

* added tsdoc to providers

* generated reference

* general fixes for generated reference

* generated api reference specs + general fixes

* add missing import react

* split utilities into different directories

* added overview page

* added link to customer authentication section

* fix lint errors

* added changeset

* fix readme

* fixed build error

* added expand fields + other sections to overview

* updated what's new section

* general refactoring

* remove unnecessary query field

* fix links

* added ignoreApi option
2024-01-05 17:03:38 +02:00

105 lines
2.8 KiB
YAML

post:
operationId: PostUploads
summary: Upload Files
description: >-
Upload at least one file to a public bucket or storage. The file upload is
handled by the file service installed on the Medusa backend.
x-authenticated: true
requestBody:
content:
multipart/form-data:
schema:
type: object
properties:
files:
type: string
format: binary
x-codeSamples:
- lang: JavaScript
label: JS Client
source:
$ref: ../code_samples/JavaScript/admin_uploads/post.js
- lang: tsx
label: Medusa React
source:
$ref: ../code_samples/tsx/admin_uploads/postundefined
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/admin_uploads/post.sh
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
tags:
- Uploads
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/AdminUploadsRes.yaml
'400':
$ref: ../components/responses/400_error.yaml
'401':
$ref: ../components/responses/unauthorized.yaml
'404':
$ref: ../components/responses/not_found_error.yaml
'409':
$ref: ../components/responses/invalid_state_error.yaml
'422':
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml
delete:
operationId: DeleteUploads
summary: Delete an Uploaded File
description: >-
Delete an uploaded file from storage. The file is deleted using the
installed file service on the Medusa backend.
x-authenticated: true
requestBody:
content:
application/json:
schema:
$ref: ../components/schemas/AdminDeleteUploadsReq.yaml
x-codeSamples:
- lang: JavaScript
label: JS Client
source:
$ref: ../code_samples/JavaScript/admin_uploads/delete.js
- lang: tsx
label: Medusa React
source:
$ref: ../code_samples/tsx/admin_uploads/deleteundefined
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/admin_uploads/delete.sh
security:
- api_token: []
- cookie_auth: []
- jwt_token: []
tags:
- Uploads
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/AdminDeleteUploadsRes.yaml
'400':
$ref: ../components/responses/400_error.yaml
'401':
$ref: ../components/responses/unauthorized.yaml
'404':
$ref: ../components/responses/not_found_error.yaml
'409':
$ref: ../components/responses/invalid_state_error.yaml
'422':
$ref: ../components/responses/invalid_request_error.yaml
'500':
$ref: ../components/responses/500_error.yaml