chore(docs): Updated API Reference (v2) (#8954)

Automated changes by [create-pull-request](https://github.com/peter-evans/create-pull-request) GitHub action

Co-authored-by: Shahed Nasser <27354907+shahednasser@users.noreply.github.com>
This commit is contained in:
github-actions[bot]
2024-09-03 07:18:42 +00:00
committed by GitHub
parent 6652db45ef
commit edc19e748b
157 changed files with 16009 additions and 35955 deletions

View File

@@ -68,13 +68,13 @@ get:
oneOf:
- type: string
title: location_id
description: The reservation's location id.
description: Filter by a location's ID to retrieve its associated reservations.
- type: array
description: The reservation's location id.
description: Filter by location IDs to retrieve its associated reservations.
items:
type: string
title: location_id
description: The location id's details.
description: A location ID.
- name: inventory_item_id
in: query
required: false
@@ -82,13 +82,17 @@ get:
oneOf:
- type: string
title: inventory_item_id
description: The reservation's inventory item id.
description: >-
Filter by an inventory item's ID to retrieve its associated
reservations.
- type: array
description: The reservation's inventory item id.
description: >-
Filter by inventory item IDs to retrieve its associated
reservations.
items:
type: string
title: inventory_item_id
description: The inventory item id's details.
description: An inventory item ID
- name: line_item_id
in: query
required: false
@@ -96,13 +100,15 @@ get:
oneOf:
- type: string
title: line_item_id
description: The reservation's line item id.
description: >-
Filter by a line item's ID to retrieve its associated
reservations.
- type: array
description: The reservation's line item id.
description: Filter by line item IDs to retrieve its associated reservations.
items:
type: string
title: line_item_id
description: The line item id's details.
description: A line item ID
- name: created_by
in: query
required: false
@@ -110,13 +116,15 @@ get:
oneOf:
- type: string
title: created_by
description: The reservation's created by.
description: >-
Filter by the ID of a user to retrieve the reservations they
created.
- type: array
description: The reservation's created by.
description: Filter by user IDs to retrieve the reservations they created.
items:
type: string
title: created_by
description: The created by's details.
description: A user's ID.
- name: description
in: query
required: false
@@ -124,42 +132,74 @@ get:
oneOf:
- type: string
title: description
description: The reservation's description.
description: >-
Filter by a reservation's description. This filter applies a
full-text match. To search by keywords, use the `q` query
parameter instead.
- type: object
description: The reservation's description.
required:
- $eq
- $ne
- $in
- $nin
- $like
- $ilike
- $re
- $contains
- $gt
- $gte
- $lt
- $lte
description: Apply filters on the reservation's description.
properties:
$eq: {}
$ne: {}
$in: {}
$nin: {}
$like: {}
$ilike: {}
$re: {}
$contains: {}
$gt: {}
$gte: {}
$lt: {}
$lte: {}
$eq:
type: string
description: Filter by an exact match.
$ne:
type: string
description: Filter by values not matching this parameter.
$in:
type: array
description: Filter by values in this array's items.
items:
type: string
$nin:
type: array
description: Filter by values not in this array's items.
items:
type: string
$like:
type: string
description: Apply a `like` filter. Useful for strings only.
$ilike:
type: string
description: >-
Apply a case-insensitive `like` filter. Useful for strings
only.
$re:
type: string
description: Apply a regex filter. Useful for strings only.
$contains:
type: array
description: >-
Filter arrays that contain some of the values of this
parameter.
items:
type: string
$gt:
type: string
description: >-
Filter by values greater than this parameter. Useful for
numbers and dates only.
$gte:
type: string
description: >-
Filter by values greater than or equal to this parameter.
Useful for numbers and dates only.
$lt:
type: string
description: >-
Filter by values less than this parameter. Useful for numbers
and dates only.
$lte:
type: string
description: >-
Filter by values less than or equal to this parameter. Useful
for numbers and dates only.
- name: created_at
in: query
description: The reservation's created at.
description: Filter by a reservation's creation date.
required: false
schema:
type: object
description: The reservation's created at.
description: Filter by a reservation's creation date.
properties:
$and:
type: array
@@ -217,150 +257,6 @@ get:
description: >-
Filter by values not matching the conditions in this
parameter.
properties:
$and:
type: array
description: >-
Join query parameters with an AND condition. Each object's
content is the same type as the expected query parameters.
items:
type: object
title: $and
$or:
type: array
description: >-
Join query parameters with an OR condition. Each object's
content is the same type as the expected query parameters.
items:
type: object
title: $or
$eq:
oneOf:
- type: string
title: $eq
description: Filter by an exact match.
- type: array
description: Filter by an exact match.
items:
type: string
title: $eq
description: Filter by an exact match.
$ne:
type: string
title: $ne
description: Filter by values not equal to this parameter.
$in:
type: array
description: Filter by values in this array.
items:
type: string
title: $in
description: Filter by values in this array.
$nin:
type: array
description: Filter by values not in this array.
items:
type: string
title: $nin
description: Filter by values not in this array.
$not:
oneOf:
- type: string
title: $not
description: >-
Filter by values not matching the conditions in this
parameter.
- type: object
description: >-
Filter by values not matching the conditions in this
parameter.
- type: array
description: >-
Filter by values not matching the conditions in this
parameter.
items:
type: string
title: $not
description: >-
Filter by values not matching the conditions in this
parameter.
$gt:
type: string
title: $gt
description: >-
Filter by values greater than this parameter. Useful for
numbers and dates only.
$gte:
type: string
title: $gte
description: >-
Filter by values greater than or equal to this parameter.
Useful for numbers and dates only.
$lt:
type: string
title: $lt
description: >-
Filter by values less than this parameter. Useful for
numbers and dates only.
$lte:
type: string
title: $lte
description: >-
Filter by values less than or equal to this parameter.
Useful for numbers and dates only.
$like:
type: string
title: $like
description: Apply a `like` filter. Useful for strings only.
$re:
type: string
title: $re
description: Apply a regex filter. Useful for strings only.
$ilike:
type: string
title: $ilike
description: >-
Apply a case-insensitive `like` filter. Useful for strings
only.
$fulltext:
type: string
title: $fulltext
description: Filter to apply on full-text properties.
$overlap:
type: array
description: >-
Filter arrays that have overlapping values with this
parameter.
items:
type: string
title: $overlap
description: >-
Filter arrays that have overlapping values with this
parameter.
$contains:
type: array
description: >-
Filter arrays that contain some of the values of this
parameter.
items:
type: string
title: $contains
description: >-
Filter arrays that contain some of the values of this
parameter.
$contained:
type: array
description: Filter arrays that contain all values of this parameter.
items:
type: string
title: $contained
description: Filter arrays that contain all values of this parameter.
$exists:
type: boolean
title: $exists
description: >-
Filter by whether a value for this parameter exists (not
`null`).
- type: array
description: >-
Filter by values not matching the conditions in this
@@ -438,11 +334,11 @@ get:
description: Filter by whether a value for this parameter exists (not `null`).
- name: updated_at
in: query
description: The reservation's updated at.
description: Filter by a reservation's update date.
required: false
schema:
type: object
description: The reservation's updated at.
description: Filter by a reservation's update date.
properties:
$and:
type: array
@@ -500,150 +396,6 @@ get:
description: >-
Filter by values not matching the conditions in this
parameter.
properties:
$and:
type: array
description: >-
Join query parameters with an AND condition. Each object's
content is the same type as the expected query parameters.
items:
type: object
title: $and
$or:
type: array
description: >-
Join query parameters with an OR condition. Each object's
content is the same type as the expected query parameters.
items:
type: object
title: $or
$eq:
oneOf:
- type: string
title: $eq
description: Filter by an exact match.
- type: array
description: Filter by an exact match.
items:
type: string
title: $eq
description: Filter by an exact match.
$ne:
type: string
title: $ne
description: Filter by values not equal to this parameter.
$in:
type: array
description: Filter by values in this array.
items:
type: string
title: $in
description: Filter by values in this array.
$nin:
type: array
description: Filter by values not in this array.
items:
type: string
title: $nin
description: Filter by values not in this array.
$not:
oneOf:
- type: string
title: $not
description: >-
Filter by values not matching the conditions in this
parameter.
- type: object
description: >-
Filter by values not matching the conditions in this
parameter.
- type: array
description: >-
Filter by values not matching the conditions in this
parameter.
items:
type: string
title: $not
description: >-
Filter by values not matching the conditions in this
parameter.
$gt:
type: string
title: $gt
description: >-
Filter by values greater than this parameter. Useful for
numbers and dates only.
$gte:
type: string
title: $gte
description: >-
Filter by values greater than or equal to this parameter.
Useful for numbers and dates only.
$lt:
type: string
title: $lt
description: >-
Filter by values less than this parameter. Useful for
numbers and dates only.
$lte:
type: string
title: $lte
description: >-
Filter by values less than or equal to this parameter.
Useful for numbers and dates only.
$like:
type: string
title: $like
description: Apply a `like` filter. Useful for strings only.
$re:
type: string
title: $re
description: Apply a regex filter. Useful for strings only.
$ilike:
type: string
title: $ilike
description: >-
Apply a case-insensitive `like` filter. Useful for strings
only.
$fulltext:
type: string
title: $fulltext
description: Filter to apply on full-text properties.
$overlap:
type: array
description: >-
Filter arrays that have overlapping values with this
parameter.
items:
type: string
title: $overlap
description: >-
Filter arrays that have overlapping values with this
parameter.
$contains:
type: array
description: >-
Filter arrays that contain some of the values of this
parameter.
items:
type: string
title: $contains
description: >-
Filter arrays that contain some of the values of this
parameter.
$contained:
type: array
description: Filter arrays that contain all values of this parameter.
items:
type: string
title: $contained
description: Filter arrays that contain all values of this parameter.
$exists:
type: boolean
title: $exists
description: >-
Filter by whether a value for this parameter exists (not
`null`).
- type: array
description: >-
Filter by values not matching the conditions in this
@@ -721,11 +473,11 @@ get:
description: Filter by whether a value for this parameter exists (not `null`).
- name: deleted_at
in: query
description: The reservation's deleted at.
description: Filter by a reservation's deletion date.
required: false
schema:
type: object
description: The reservation's deleted at.
description: Filter by a reservation's deletion date.
properties:
$and:
type: array
@@ -783,150 +535,6 @@ get:
description: >-
Filter by values not matching the conditions in this
parameter.
properties:
$and:
type: array
description: >-
Join query parameters with an AND condition. Each object's
content is the same type as the expected query parameters.
items:
type: object
title: $and
$or:
type: array
description: >-
Join query parameters with an OR condition. Each object's
content is the same type as the expected query parameters.
items:
type: object
title: $or
$eq:
oneOf:
- type: string
title: $eq
description: Filter by an exact match.
- type: array
description: Filter by an exact match.
items:
type: string
title: $eq
description: Filter by an exact match.
$ne:
type: string
title: $ne
description: Filter by values not equal to this parameter.
$in:
type: array
description: Filter by values in this array.
items:
type: string
title: $in
description: Filter by values in this array.
$nin:
type: array
description: Filter by values not in this array.
items:
type: string
title: $nin
description: Filter by values not in this array.
$not:
oneOf:
- type: string
title: $not
description: >-
Filter by values not matching the conditions in this
parameter.
- type: object
description: >-
Filter by values not matching the conditions in this
parameter.
- type: array
description: >-
Filter by values not matching the conditions in this
parameter.
items:
type: string
title: $not
description: >-
Filter by values not matching the conditions in this
parameter.
$gt:
type: string
title: $gt
description: >-
Filter by values greater than this parameter. Useful for
numbers and dates only.
$gte:
type: string
title: $gte
description: >-
Filter by values greater than or equal to this parameter.
Useful for numbers and dates only.
$lt:
type: string
title: $lt
description: >-
Filter by values less than this parameter. Useful for
numbers and dates only.
$lte:
type: string
title: $lte
description: >-
Filter by values less than or equal to this parameter.
Useful for numbers and dates only.
$like:
type: string
title: $like
description: Apply a `like` filter. Useful for strings only.
$re:
type: string
title: $re
description: Apply a regex filter. Useful for strings only.
$ilike:
type: string
title: $ilike
description: >-
Apply a case-insensitive `like` filter. Useful for strings
only.
$fulltext:
type: string
title: $fulltext
description: Filter to apply on full-text properties.
$overlap:
type: array
description: >-
Filter arrays that have overlapping values with this
parameter.
items:
type: string
title: $overlap
description: >-
Filter arrays that have overlapping values with this
parameter.
$contains:
type: array
description: >-
Filter arrays that contain some of the values of this
parameter.
items:
type: string
title: $contains
description: >-
Filter arrays that contain some of the values of this
parameter.
$contained:
type: array
description: Filter arrays that contain all values of this parameter.
items:
type: string
title: $contained
description: Filter arrays that contain all values of this parameter.
$exists:
type: boolean
title: $exists
description: >-
Filter by whether a value for this parameter exists (not
`null`).
- type: array
description: >-
Filter by values not matching the conditions in this
@@ -1021,7 +629,7 @@ get:
schema:
allOf:
- type: object
description: SUMMARY
description: The paginated list of reservations.
required:
- limit
- offset
@@ -1030,23 +638,25 @@ get:
limit:
type: number
title: limit
description: The reservation's limit.
description: The maximum number of items returned.
offset:
type: number
title: offset
description: The reservation's offset.
description: >-
The number of items skipped before retrieving the returned
items.
count:
type: number
title: count
description: The reservation's count.
description: The total number of items.
- type: object
description: SUMMARY
description: The paginated list of reservations.
required:
- reservations
properties:
reservations:
type: array
description: The reservation's reservations.
description: The list of reservations`.
items:
$ref: ../components/schemas/ReservationResponse.yaml
'400':