Upsert a list

Request

Creates or updates (upserts) a list with a specified ID.

Security
SecretApiKey or JWT
Path
idstring, <= 50 characters^[@~\-\.\w]+$required
ID of the resource.
Bodyapplication/jsonrequired
List resource.
descriptionstringrequired
Description of the list.
valuesArray of stringsrequired
Values in the list.
curl -i -X PUT \
  'https://www.rebilly.com/_mock/catalog/all/lists/{id}' \
  -H 'Content-Type: application/json' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE' \
  -d '{
    "description": "string",
    "values": [
      "string"
    ]
  }'

Responses

List updated.
Headers
Rate-Limit-Limitinteger

Maximum number of requests available at one time for this rate limit. For more information, see Rate limits.

Example:500
Rate-Limit-Remaininginteger

Number of requests still available for this rate limit. For more information, see Rate limits.

Example:499
Bodyapplication/json
idstring, <= 50 charactersread-only
ID of the list.
Example:"lst_0YVCXVQH84DEF93D8VBTJQ9TGK"
versioninteger, >= 1read-only
Version of the list.
descriptionstringrequired
Description of the list.
valuesArray of stringsrequired
Values in the list.
createdTimestring, (date-time)(CreatedTime)read-only
Date and time when the resource is created. This value is set automatically when the resource is created.
updatedTimestring, (date-time)(UpdatedTime)read-only
Date and time when the resource is updated. This value is set automatically when the resource is updated.
_linksArray of objects(SelfLink)read-only
Related links.
Response
{
  "id": "lst_0YVCXVQH84DEF93D8VBTJQ9TGK",
  "version": 1,
  "description": "string",
  "values": [
    "string"
  ],
  "createdTime": "2019-08-24T14:15:22Z",
  "updatedTime": "2019-08-24T14:15:22Z",
  "_links": [
    { … }
  ]
}