Files
medusa-store/www/apps/api-reference/specs/admin/paths/admin_stock-locations.yaml
Shahed Nasser fa7c94b4cc docs: create docs workspace (#5174)
* docs: migrate ui docs to docs universe

* created yarn workspace

* added eslint and tsconfig configurations

* fix eslint configurations

* fixed eslint configurations

* shared tailwind configurations

* added shared ui package

* added more shared components

* migrating more components

* made details components shared

* move InlineCode component

* moved InputText

* moved Loading component

* Moved Modal component

* moved Select components

* Moved Tooltip component

* moved Search components

* moved ColorMode provider

* Moved Notification components and providers

* used icons package

* use UI colors in api-reference

* moved Navbar component

* used Navbar and Search in UI docs

* added Feedback to UI docs

* general enhancements

* fix color mode

* added copy colors file from ui-preset

* added features and enhancements to UI docs

* move Sidebar component and provider

* general fixes and preparations for deployment

* update docusaurus version

* adjusted versions

* fix output directory

* remove rootDirectory property

* fix yarn.lock

* moved code component

* added vale for all docs MD and MDX

* fix tests

* fix vale error

* fix deployment errors

* change ignore commands

* add output directory

* fix docs test

* general fixes

* content fixes

* fix announcement script

* added changeset

* fix vale checks

* added nofilter option

* fix vale error
2023-09-21 20:57:15 +03:00

215 lines
5.9 KiB
YAML

get:
operationId: GetStockLocations
summary: List Stock Locations
description: >-
Retrieve a list of stock locations. The stock locations can be filtered by
fields such as `name` or `created_at`. The stock locations can also be
sorted or paginated.
x-authenticated: true
parameters:
- in: query
name: id
description: Filter by ID.
schema:
type: string
- in: query
name: name
description: Filter by name.
schema:
type: string
- in: query
name: order
description: A stock-location field to sort-order the retrieved stock locations by.
schema:
type: string
- in: query
name: created_at
description: Filter by a creation date range.
schema:
type: object
properties:
lt:
type: string
description: filter by dates less than this date
format: date
gt:
type: string
description: filter by dates greater than this date
format: date
lte:
type: string
description: filter by dates less than or equal to this date
format: date
gte:
type: string
description: filter by dates greater than or equal to this date
format: date
- in: query
name: updated_at
description: Filter by an update date range.
schema:
type: object
properties:
lt:
type: string
description: filter by dates less than this date
format: date
gt:
type: string
description: filter by dates greater than this date
format: date
lte:
type: string
description: filter by dates less than or equal to this date
format: date
gte:
type: string
description: filter by dates greater than or equal to this date
format: date
- in: query
name: deleted_at
description: Filter by a deletion date range.
schema:
type: object
properties:
lt:
type: string
description: filter by dates less than this date
format: date
gt:
type: string
description: filter by dates greater than this date
format: date
lte:
type: string
description: filter by dates less than or equal to this date
format: date
gte:
type: string
description: filter by dates greater than or equal to this date
format: date
- in: query
name: offset
description: >-
The number of stock locations to skip when retrieving the stock
locations.
schema:
type: integer
default: 0
- in: query
name: limit
description: Limit the number of stock locations returned.
schema:
type: integer
default: 20
- in: query
name: expand
description: >-
Comma-separated relations that should be expanded in the returned stock
locations.
schema:
type: string
- in: query
name: fields
description: >-
Comma-separated fields that should be included in the returned stock
locations.
schema:
type: string
x-codegen:
method: list
queryParams: AdminGetStockLocationsParams
x-codeSamples:
- lang: JavaScript
label: JS Client
source:
$ref: ../code_samples/JavaScript/admin_stock-locations/get.js
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/admin_stock-locations/get.sh
security:
- api_token: []
- cookie_auth: []
tags:
- Stock Locations
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/AdminStockLocationsListRes.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
post:
operationId: PostStockLocations
summary: Create a Stock Location
description: Create a Stock Location.
x-authenticated: true
parameters:
- in: query
name: expand
description: >-
Comma-separated relations that should be expanded in the returned stock
location.
schema:
type: string
- in: query
name: fields
description: >-
Comma-separated fields that should be included in the returned stock
location.
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: ../components/schemas/AdminPostStockLocationsReq.yaml
x-codegen:
method: create
x-codeSamples:
- lang: JavaScript
label: JS Client
source:
$ref: ../code_samples/JavaScript/admin_stock-locations/post.js
- lang: Shell
label: cURL
source:
$ref: ../code_samples/Shell/admin_stock-locations/post.sh
security:
- api_token: []
- cookie_auth: []
tags:
- Stock Locations
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: ../components/schemas/AdminStockLocationsRes.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