Files
medusa-store/docs/api/admin/paths/draft-orders.yaml
2023-02-09 09:50:55 +02:00

107 lines
2.8 KiB
YAML

post:
operationId: PostDraftOrders
summary: Create a Draft Order
description: Creates a Draft Order
x-authenticated: true
requestBody:
content:
application/json:
schema:
$ref: ../components/schemas/AdminPostDraftOrdersReq.yaml
x-codegen:
method: create
x-codeSamples:
- lang: JavaScript
label: JS Client
source:
$ref: ../code_samples/JavaScript/draft-orders/post.js
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/draft-orders/post.sh
security:
- api_token: []
- cookie_auth: []
tags:
- Draft Order
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/AdminDraftOrdersRes.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
get:
operationId: GetDraftOrders
summary: List Draft Orders
description: Retrieves an list of Draft Orders
x-authenticated: true
parameters:
- in: query
name: offset
description: The number of items to skip before the results.
schema:
type: number
default: '0'
- in: query
name: limit
description: Limit the number of items returned.
schema:
type: number
default: '50'
- in: query
name: q
description: >-
a search term to search emails in carts associated with draft orders and
display IDs of draft orders
schema:
type: string
x-codegen:
method: list
queryParams: AdminGetDraftOrdersParams
x-codeSamples:
- lang: JavaScript
label: JS Client
source:
$ref: ../code_samples/JavaScript/draft-orders/get.js
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/draft-orders/get.sh
security:
- api_token: []
- cookie_auth: []
tags:
- Draft Order
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/AdminDraftOrdersListRes.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