Inventory Adjustments
Retrieve a Single Inventory Adjustment by ID #
|
Sample Object
|
Retrieves a single manual Collateral inventory adjustment by its ID.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the manual inventory adjustment.
|
Use an ID from this inventory-adjustment collection. Event and Capital reservation IDs are different records, even if the numbers match.
|
| $include_record_revision | Boolean | No |
Set to
true to include a record_revision for checking a later update.
|
Default: false. Use the returned value with PATCH /v1/assets/inventory_adjustments or DELETE /v1/assets/inventory_adjustments.
|
| $result_format | String | No |
By default, the response is a single object. Send
array to get it inside a one-item array.
|
Allowed values:
array |
| $on_error_return_empty_result | Boolean | No |
Set to
true to return an empty result for supported validation or not-found errors.
|
Default: false. Other errors keep their normal status.
|
| $include_error_list_in_response_message | Boolean | No |
Set to
true to include individual validation errors in the response message.
|
Default: false. The normal error response still includes its error list.
|
| If-None-Match | String | No |
Send the ETag from an earlier response when checking whether this result changed.
|
Optional request header. A matching current result returns HTTP 304 with no body; reuse your earlier response. This header compares GET responses. It cannot prevent a conflicting update.
|
Good to know
Retrieves one manual Collateral inventory adjustment. Set $include_record_revision=true if you plan to update it and want to check for changes before saving.
Understanding the quantity and dates
quantity_adjustment is the signed change: positive for an increase and negative for a decrease. quantity is its size without the sign. For example, a decrease of 10 has quantity_adjustment=-10 and quantity=10.
Older zero adjustments remain visible. is_quantity_editable=false marks an inherited quantity outside the editing range; it remains readable.
An older return_date is the date when the adjustment’s quantity effect was scheduled to reverse. It does not confirm that an item was physically returned. GET preserves that historical date; new manual adjustments normally have no return date.
What the response includes
The response contains the adjustment itself, its Collateral item, saved description and formatting, Shipping Logistics choice, flag, star and checked status, and location when it is available to your workspace. It does not include attachments, Logistical Records or related-item links.
The Storage Location ID and name are included only when the location is in your workspace. Shared-Asset access does not grant access to the owner’s manual inventory.
description is returned as text: HTML-encoded, with line breaks as <br/>. Formatting added in ExhibitDay is not returned. Account identifiers and file-storage details are not exposed.
Getting a revision for an update
- Retrieve the adjustment with
$include_record_revision=true. - Send the returned
record_revisionasexpected_revisionin PATCH /v1/assets/inventory_adjustments, or in DELETE /v1/assets/inventory_adjustments to delete it only if it is unchanged.
What $include_record_revision covers
Set $include_record_revision=true to receive record_revision in this GET response. It covers the adjustment fields, formatting saved in ExhibitDay, Logistical Records and related-item links. Attachment metadata and file contents are outside its scope.
A stale revision makes PATCH or DELETE return HTTP 409 with error_code=record_changed and change nothing. Retrieve the adjustment again and review the current values before deciding whether to retry.
Handling a missing adjustment
A missing or inaccessible adjustment returns HTTP 404. Set $on_error_return_empty_result=true for an empty object instead, or an empty array when $result_format=array. Current API access is still checked.
Matching copies of a parameter count once. Malformed inputs, conflicting copies, authentication errors, read conflicts and unexpected errors retain their normal status. A read conflict returns HTTP 409 with error_code=record_changed; retrieve the record again.
Checking whether a response changed
Normal API-key and access checks still apply. This header compares the response; it does not authorize access or protect an update.
- Save the response body and its
ETagheader from an earlier GET. - Repeat the same GET, including the same filters and response options, with that ETag in the
If-None-Matchheader. - If the response is HTTP
304, keep using your saved body. If it is HTTP200, use the new body and ETag.
curl -X GET "https://api.exhibitday.com/v1/assets/inventory_adjustments/info?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/assets/inventory_adjustments/info?" + new URLSearchParams({ "id": "12345" }), {
method: "GET",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.get(
"https://api.exhibitday.com/v1/assets/inventory_adjustments/info",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.exhibitday.com/v1/assets/inventory_adjustments/info?id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/assets/inventory_adjustments/info?id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/assets/inventory_adjustments/info?id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/assets/inventory_adjustments/info?id=12345')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/assets/inventory_adjustments/info?id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"exhibitday_url": "https://www.exhibitday.com/Workspace/Asset/98765?aid=12346&reservation_id=12345",
"id": 12345,
"asset_id": 12346,
"asset_name": "Printed brochures",
"storage_location_id": 2345,
"storage_location_name": "Main Warehouse",
"effective_date": "2030-01-02",
"return_date": null,
"quantity_adjustment": 10,
"quantity": 10,
"is_increase": true,
"is_quantity_editable": true,
"description": "Additional printed brochures arrived",
"shipping_logistics_id": 1,
"is_flagged": false,
"is_starred": false,
"is_checked": false,
"inventory_adjustment_created_timestamp": "2030-01-01T17:00:00Z"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Inventory Adjustment not found. Invalid Inventory Adjustment ID: 12345.",
"error_code": "not_found",
"errors": [
"Inventory Adjustment not found. Invalid Inventory Adjustment ID: 12345."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Inventory could not be read while it changed; read again.",
"error_code": "record_changed",
"errors": [
"No data was changed by this read."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Retrieve Inventory Adjustments #
|
Retrieves manual Collateral inventory adjustments.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| filter_by_inventory_adjustment_id | Number | No |
Only return this manual inventory adjustment.
|
|
| filter_by_asset_id | Number | No |
Only return adjustments for this Collateral item.
|
|
| filter_by_storage_location_id | Number | No |
Only return adjustments at this Storage Location.
|
|
| filter_by_effective_date_greater_than_or_equal_to | Date | No |
Only return adjustments effective on or after this date.
|
Use
YYYY-MM-DD. The whole calendar date is compared, including older entries saved with a time of day. |
| filter_by_effective_date_smaller_than_or_equal_to | Date | No |
Only return adjustments effective on or before this date.
|
Use
YYYY-MM-DD. It must not be before the lower date when both are supplied. |
| $result_sort | String | No |
Order adjustments by effective date, creation time or ID. Omit for effective date ascending. Date and time ties use ID ascending. Unsupported values are refused. Use the values exactly as shown (lowercase).
|
Allowed values:
effective_date_asc | effective_date_desc | create_timestamp_asc | create_timestamp_desc | id_asc | id_desc |
| $limit | Number | No |
The maximum number of matching adjustments to return.
|
Send one positive whole number. Omit to return all matches after
$offset; there is no fixed page-size cap. |
| $offset | Number | No |
The number of matching adjustments to skip.
|
Default: 0. Send a nonnegative whole number.
|
| $result_format | String | No |
By default, the response is an object containing
list_data and the paging totals (records_found, total_records, has_more). Send array to get just a JSON array of the records, or wrapped_in_array to get the default object inside a one-item array.
|
Allowed values:
array | wrapped_in_array |
| $on_error_return_empty_result | Boolean | No |
Set to
true to return an empty collection for supported validation errors.
|
Default: false. No matching adjustments normally returns an empty collection.
|
| $include_error_list_in_response_message | Boolean | No |
Set to
true to include individual validation errors in the response message.
|
Default: false. The normal error response still includes its error list.
|
| If-None-Match | String | No |
Send the ETag from an earlier response when checking whether this result changed.
|
Optional request header. A matching current result returns HTTP 304 with no body; reuse your earlier response. This header compares GET responses. It cannot prevent a conflicting update.
|
Good to know
Retrieves manual increases and decreases in Collateral inventory, such as newly received brochures or stock removed from storage. These entries are not assigned to an Event. By default, it returns all matching adjustments in Effective Date order. Add filters or paging to narrow the result.
Filtering and paging
Filters work together. A matching adjustment must satisfy every ID and date filter you provide. Event reservations and Capital Asset reservations are excluded; these manual entries are always for Collateral inventory.
records_found is the number of rows in this response; total_records is the filtered count before paging. has_more indicates whether more matches remain. Counts and pages may change while inventory is edited.
The collection does not issue revisions and does not support changed-since filtering.
Understanding the quantity and dates
quantity_adjustment is the signed change: positive for an increase and negative for a decrease. quantity is its size without the sign. For example, a decrease of 10 has quantity_adjustment=-10 and quantity=10.
Older zero adjustments remain visible. is_quantity_editable=false marks an inherited quantity outside the editing range; it remains readable.
An older return_date is the date when the adjustment’s quantity effect was scheduled to reverse. It does not confirm that an item was physically returned. GET preserves that historical date; new manual adjustments normally have no return date.
What the response includes
The response contains the adjustment itself, its Collateral item, saved description and formatting, Shipping Logistics choice, flag, star and checked status, and location when it is available to your workspace. It does not include attachments, Logistical Records or related-item links.
The Storage Location ID and name are included only when the location is in your workspace. Shared-Asset access does not grant access to the owner’s manual inventory.
description is returned as text: HTML-encoded, with line breaks as <br/>. Formatting added in ExhibitDay is not returned. Account identifiers and file-storage details are not exposed.
Handling errors
Matching copies of a parameter count once. Malformed inputs, conflicting copies, authentication errors, read conflicts and unexpected errors keep their normal error response, even when $on_error_return_empty_result=true.
If concurrent changes prevent the read, HTTP 409 with error_code=record_changed means you should retrieve the data again. This read changes no data.
Checking whether a response changed
Normal API-key and access checks still apply. This header compares the response; it does not authorize access or protect an update.
- Save the response body and its
ETagheader from an earlier GET. - Repeat the same GET, including the same filters and response options, with that ETag in the
If-None-Matchheader. - If the response is HTTP
304, keep using your saved body. If it is HTTP200, use the new body and ETag.
curl -X GET "https://api.exhibitday.com/v1/assets/inventory_adjustments" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/assets/inventory_adjustments", {
method: "GET",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.get(
"https://api.exhibitday.com/v1/assets/inventory_adjustments",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.GetAsync("https://api.exhibitday.com/v1/assets/inventory_adjustments");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/assets/inventory_adjustments"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/assets/inventory_adjustments');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/assets/inventory_adjustments')
request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("GET", "https://api.exhibitday.com/v1/assets/inventory_adjustments", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"records_found": 1,
"total_records": 1,
"has_more": false,
"list_type": "inventory_adjustment",
"list_data": [
{
"exhibitday_url": "https://www.exhibitday.com/Workspace/Asset/98765?aid=12346&reservation_id=12345",
"id": 12345,
"asset_id": 12346,
"asset_name": "Printed brochures",
"storage_location_id": 2345,
"storage_location_name": "Main Warehouse",
"effective_date": "2030-01-02",
"return_date": null,
"quantity_adjustment": 10,
"quantity": 10,
"is_increase": true,
"is_quantity_editable": true,
"description": "Additional printed brochures arrived",
"shipping_logistics_id": 1,
"is_flagged": false,
"is_starred": false,
"is_checked": false,
"inventory_adjustment_created_timestamp": "2030-01-01T17:00:00Z"
}
]
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Inventory could not be read while it changed; read again.",
"error_code": "record_changed",
"errors": [
"No data was changed by this read."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Add an Inventory Adjustment #
|
Adds a manual Collateral inventory adjustment.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| asset_id | Number | Yes |
The ID of the Active Collateral/Multi-quantity item whose inventory you want to adjust. Capital Assets are not accepted.
|
|
| quantity | Number | Yes |
The size of the increase or decrease.
|
One positive whole number from 1 through 2,147,483,647. Send the direction separately with
is_increase. |
| is_increase | Boolean | Yes |
Set to
true to add stock, or false to remove stock.
|
|
| description | String | Yes |
The description explaining this inventory change.
|
Plain text, up to 1,000 characters. Line breaks are preserved. GET returns the description as text: HTML-encoded, with line breaks as <br/>. The description cannot be blank.
|
| is_effective_immediately | Boolean | No |
Set to
true to use today, or false when choosing an Effective Date.
|
Uses today in your workspace’s time zone.
true overrides a supplied effective_date. If omitted, a supplied date is used; otherwise the date defaults to today. |
| effective_date | Date | When is_effective_immediately=false |
The date when this inventory change should take effect.
|
Use
YYYY-MM-DD. |
| storage_location_id | Number | For an existing location |
The Storage Location for this inventory change.
|
Choose an existing location, or supply both new-location fields for an increase. Do not combine the two choices.
|
| new_storage_location_name | String | For a new location |
The name of a new Storage Location for this increase.
|
1–120 characters, excluding surrounding spaces. A new location is available only when
is_increase=true. |
| new_storage_location_address | String | For a new location |
The full street address of the new Storage Location.
|
10–500 characters, excluding surrounding spaces.
|
| shipping_logistics_id | Number | No |
The Shipping Logistics choice to record for this adjustment. Omit for Unspecified.
|
Allowed values:
1 (Unspecified) | 2 (Advance Warehouse) | 3 (Direct Shipment) | 4 (Other) |
| is_flagged | Boolean | No |
Whether to flag this inventory entry.
|
Default: false.
|
| is_starred | Boolean | No |
Whether to star this inventory entry.
|
Default: false.
|
| is_checked | Boolean | No |
Whether to mark this inventory entry as checked.
|
Default: false.
|
| $result_format | String | No |
By default, the response is a single object. Send
array to get it inside a one-item array.
|
Allowed values:
array |
| Idempotency-Key | String | No |
Send a unique key if you may retry this same create request.
|
Optional request header: 1–255 visible ASCII characters without spaces, such as a UUID. Reuse the same key only for the same request. Successful responses can be replayed for 24 hours.
|
Good to know
Records a manual increase or decrease in Collateral stock without assigning it to an Event. The quantity takes effect on the chosen Effective Date. Use an existing Storage Location, or create a new location when adding stock. The response includes exhibitday_url, the record's page in ExhibitDay.
Recording an inventory change
- Send
asset_id, a positivequantity, the direction inis_increase, and a description. - Choose the Effective Date and one Storage Location option below.
- Read the created adjustment from the response. An increase adds the quantity; a decrease subtracts it.
Choosing the date
- For today, omit both date options or send
is_effective_immediately=true. - For another date, send
effective_date. You can also sendis_effective_immediately=false, which requires the date. - If
is_effective_immediately=trueand a date are both supplied, today is used.
Choosing the Storage Location
- For an existing location, send its
storage_location_id. It must be in your workspace. - For a new location, send
is_increase=true,new_storage_location_nameandnew_storage_location_address, and omitstorage_location_id. - The new location and inventory increase are saved together. A refused adjustment leaves no unused new location. Address lookup is best effort; a failed lookup keeps the entered address.
Inventory limits and side effects
A new adjustment requires an Active Collateral/Multi-quantity item. Shared-Asset access does not grant access to the owner’s manual inventory. Capital Assets cannot be adjusted because they are single-quantity items. Capital Asset and Event reservations use /v1/assets/reservations.
Inventory totals may be negative. The API refuses an adjustment that would put a resulting stored total outside the supported whole-number range. It does not impose a rule that every total must stay nonnegative.
This method does not create an Event reservation, related-item links, attachments or a scheduled return. It sends no follower or business notifications. A confirmed change is recorded in history; a history-writing failure does not undo the saved adjustment.
Retrying the same create
Use the optional Idempotency-Key request header if you may retry the same create request. Reuse that key only with the same request so a completed response can be replayed without creating another adjustment.
If the save outcome cannot be confirmed, check the adjustment and inventory before retrying. The API does not automatically repeat the action. expected_revision is not supported on POST.
Sending text with commas
Use JSON, the query string or a form field for a description or new location that contains a comma.
curl -X POST "https://api.exhibitday.com/v1/assets/inventory_adjustments" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"asset_id\":12345,\"storage_location_id\":12345,\"quantity\":10,\"is_increase\":true,\"description\":\"Additional printed brochures arrived\"}"
const response = await fetch("https://api.exhibitday.com/v1/assets/inventory_adjustments", {
method: "POST",
headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ "asset_id": 12345, "storage_location_id": 12345, "quantity": 10, "is_increase": true, "description": "Additional printed brochures arrived" })
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.post(
"https://api.exhibitday.com/v1/assets/inventory_adjustments",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"asset_id": 12345, "storage_location_id": 12345, "quantity": 10, "is_increase": True, "description": "Additional printed brochures arrived"},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.PostAsync("https://api.exhibitday.com/v1/assets/inventory_adjustments",
JsonContent.Create(new { asset_id = 12345, storage_location_id = 12345, quantity = 10, is_increase = true, description = "Additional printed brochures arrived" }));
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/assets/inventory_adjustments"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"asset_id\":12345,\"storage_location_id\":12345,\"quantity\":10,\"is_increase\":true,\"description\":\"Additional printed brochures arrived\"}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/assets/inventory_adjustments');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"asset_id":12345,"storage_location_id":12345,"quantity":10,"is_increase":true,"description":"Additional printed brochures arrived"}',
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/assets/inventory_adjustments')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"asset_id":12345,"storage_location_id":12345,"quantity":10,"is_increase":true,"description":"Additional printed brochures arrived"}'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
"strings"
)
func main() {
request, err := http.NewRequest("POST", "https://api.exhibitday.com/v1/assets/inventory_adjustments", strings.NewReader("{\"asset_id\":12345,\"storage_location_id\":12345,\"quantity\":10,\"is_increase\":true,\"description\":\"Additional printed brochures arrived\"}"))
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", "application/json")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"exhibitday_url": "https://www.exhibitday.com/Workspace/Asset/98765?aid=12345&reservation_id=23456",
"id": 23456,
"asset_id": 12345,
"asset_name": "Printed brochures",
"storage_location_id": 12345,
"storage_location_name": "Main Warehouse",
"effective_date": "2030-01-02",
"return_date": null,
"quantity_adjustment": 10,
"quantity": 10,
"is_increase": true,
"is_quantity_editable": true,
"description": "Additional printed brochures arrived",
"shipping_logistics_id": 1,
"is_flagged": false,
"is_starred": false,
"is_checked": false,
"inventory_adjustment_created_timestamp": "2030-01-01T17:00:00Z"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "This Idempotency-Key was already used with a different request. Use a new key for a new request.",
"error_code": "idempotency_key_reused",
"errors": [
"This Idempotency-Key was already used with a different request. Use a new key for a new request."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "Unable to make an inventory adjustment. This asset is a Capital Asset. Inventory adjustments can only be made to Collateral/Multi-quantity items.",
"error_code": "invalid_request",
"errors": [
"Unable to make an inventory adjustment. This asset is a Capital Asset. Inventory adjustments can only be made to Collateral/Multi-quantity items."
],
"error_params": [
"asset_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Asset not found. Invalid Asset ID: 12345.",
"error_code": "not_found",
"errors": [
"Asset not found. Invalid Asset ID: 12345."
],
"error_params": [
"asset_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A request with this Idempotency-Key is still being processed. Retry after a moment.",
"error_code": "idempotency_key_in_use",
"errors": [
"A request with this Idempotency-Key is still being processed. Retry after a moment."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"A previous request with this Idempotency-Key did not finish and its outcome is unknown, so this retry was not run to avoid creating a duplicate. Check whether the earlier request succeeded; to try again, use a new Idempotency-Key."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The saved response cannot be replayed safely.",
"error_code": "idempotency_key_indeterminate",
"errors": [
"The earlier request with this Idempotency-Key completed, but its saved response cannot be returned safely. This retry was not run and its key was not released. Look for the existing record with a GET; use a new Idempotency-Key only after checking whether another create is needed."
],
"error_params": [
"Idempotency-Key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The inventory adjustment or its content changed while the request was being saved. Read it again before deciding whether to retry; nothing was changed.",
"error_code": "record_changed",
"errors": [
"The inventory adjustment or its content changed while the request was being saved. Read it again before deciding whether to retry; nothing was changed."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Unable to make an inventory adjustment. The Collateral/Multi-quantity item is currently archived. Inventory adjustments cannot be made to archived assets.",
"error_code": "invalid_request",
"errors": [
"Unable to make an inventory adjustment. The Collateral/Multi-quantity item is currently archived. Inventory adjustments cannot be made to archived assets."
],
"error_params": [
"asset_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Update an Inventory Adjustment #
|
Updates a manual Collateral inventory adjustment.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the manual inventory adjustment you want to update.
|
|
| effective_date | Date | No |
The date the adjustment affects inventory. Omit to keep the saved date and any previously stored time of day.
|
YYYY-MM-DD.
|
| storage_location_id | Number | No |
The ID of the Storage Location for the adjustment. To move the adjustment, choose another Storage Location in your workspace.
|
|
| quantity | Number | No |
The corrected number of units for this adjustment. Use
is_increase to set the direction.
|
Whole number from 1 through 2,147,483,647.
|
| is_increase | Boolean | No |
Set to
true for an inventory increase or false for a decrease. Omit to keep the saved direction.
|
|
| description | String | No |
The reason for the adjustment, in plain text. An older description that exceeds a limit can retain its existing length.
|
Plain text, up to 1,000 characters. Line breaks are preserved. GET returns the description as text: HTML-encoded, with line breaks as <br/>.
|
| shipping_logistics_id | Number | No |
The Shipping Logistics choice. Omit to keep the current choice.
|
Allowed values:
1 (Unspecified) | 2 (Advance Warehouse) | 3 (Direct Shipment) | 4 (Other) |
| is_flagged | Boolean | No |
Set to
true to flag the adjustment or false to remove the flag.
|
|
| is_starred | Boolean | No |
Set to
true to star the adjustment or false to remove the star.
|
|
| is_checked | Boolean | No |
Set to
true to mark the adjustment as checked or false to uncheck it.
|
|
| expected_revision | String | No |
The record_revision returned when you retrieved this record. Include it to avoid overwriting someone else's changes. Omit it to skip this check.
|
|
| $ignore_params_with_empty_values | Boolean | No |
Set to
true to ignore editable fields sent as JSON null. The string "null" still requests a clear and is rejected.
|
Default: false.
|
Good to know
Updates a manual inventory adjustment for a Collateral/Multi-quantity item. An adjustment increases or decreases the quantity at a Storage Location. Its Effective Date determines when that change affects inventory totals.
Changing adjustment values
Include id in every request. Send only the editable fields you want to change. For example, to correct an increase from 12 units to 10, send quantity=10 and omit is_increase. The adjustment will add 10 units instead of 12.
Omitting an editable field or sending a blank value keeps its saved value. These fields cannot be cleared. If a description contains a comma, send it in a JSON body, query string or form field.
Inventory totals may be negative. A change is rejected if a resulting total falls outside the supported whole-number range. An older adjustment whose saved quantity is outside the editing range cannot be updated. Existing adjustments on an archived item can still be corrected. Shared-Asset access does not grant access to the owner’s manual inventory.
Updating an older adjustment with a return date
GET /v1/assets/inventory_adjustments/info can return a return_date for older adjustments. On that date, the adjustment's effect on inventory is reversed. Editing one of these adjustments removes its scheduled reversal. This also applies if you change only the flag, star or checked status.
If every value you send matches the saved values and there is no other effective change, the API keeps the reversal and makes no change to the saved dates, formatting, revision or history.
Avoiding conflicting updates
- Retrieve the adjustment with
GET /v1/assets/inventory_adjustments/infoand set$include_record_revision=true. - In your PATCH request, set
expected_revisionto the exactrecord_revisionreturned by GET.
Handling revisions and conflicts
The revision covers the adjustment fields, formatting saved in ExhibitDay, Logistical Records and related-item links. Attachment metadata and file contents are outside its scope.
If any covered value differs from what you read, the API returns HTTP 409 with error_code=record_changed and saves nothing. Retrieve the adjustment again, review its current values and decide whether to retry. A value that changed and was later changed back still matches.
When you send expected_revision, a successful response includes the adjustment’s current record_revision. A blank, null or malformed revision, or different revision values sent in the same request, returns HTTP 400 with error_code=invalid_request.
Retrying a request
If you cannot tell whether the update succeeded, retrieve the adjustment and check the item’s inventory before retrying. The API does not retry automatically. This endpoint ignores the Idempotency-Key header. A history-writing failure does not undo an update that was saved.
Updating a manual inventory adjustment sends no follower or business notifications.
curl -X PATCH "https://api.exhibitday.com/v1/assets/inventory_adjustments" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"id\":12345,\"description\":\"Additional printed brochures arrived\"}"
const response = await fetch("https://api.exhibitday.com/v1/assets/inventory_adjustments", {
method: "PATCH",
headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ "id": 12345, "description": "Additional printed brochures arrived" })
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.patch(
"https://api.exhibitday.com/v1/assets/inventory_adjustments",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"id": 12345, "description": "Additional printed brochures arrived"},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Net.Http.Json;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.PatchAsync("https://api.exhibitday.com/v1/assets/inventory_adjustments",
JsonContent.Create(new { id = 12345, description = "Additional printed brochures arrived" }));
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/assets/inventory_adjustments"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.method("PATCH", HttpRequest.BodyPublishers.ofString("{\"id\":12345,\"description\":\"Additional printed brochures arrived\"}"))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/assets/inventory_adjustments');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'PATCH',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"id":12345,"description":"Additional printed brochures arrived"}',
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/assets/inventory_adjustments')
request = Net::HTTP::Patch.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"id":12345,"description":"Additional printed brochures arrived"}'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
"strings"
)
func main() {
request, err := http.NewRequest("PATCH", "https://api.exhibitday.com/v1/assets/inventory_adjustments", strings.NewReader("{\"id\":12345,\"description\":\"Additional printed brochures arrived\"}"))
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
request.Header.Set("Content-Type", "application/json")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"status_code": 200,
"status": "OK",
"message": "Inventory Adjustment updated.",
"errors": []
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Inventory Adjustment not found. Invalid Inventory Adjustment ID: 12345.",
"error_code": "not_found",
"errors": [
"Inventory Adjustment not found. Invalid Inventory Adjustment ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "This adjustment changed since you read it; nothing was changed.",
"error_code": "record_changed",
"errors": [
"This adjustment changed since you read it; nothing was changed."
],
"error_params": [
"expected_revision"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The inventory adjustment or its content changed while the request was being saved. Read it again before deciding whether to retry; nothing was changed.",
"error_code": "record_changed",
"errors": [
"The inventory adjustment or its content changed while the request was being saved. Read it again before deciding whether to retry; nothing was changed."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
Delete an Inventory Adjustment #
|
Deletes a manual Collateral inventory adjustment.
Note: Inputs that do not apply to this operation, including the ignore-empty option, are ignored and reported in the X-API-Warnings response header.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The ID of the manual adjustment to remove.
|
Its Collateral/Multi-quantity item is found automatically. Event and Capital reservation IDs are not accepted.
|
| expected_revision | String | No |
The record_revision returned when you retrieved this adjustment. Include it to delete the adjustment only if it is unchanged since that read. Omit it to skip this check.
|
Good to know
Permanently removes a manual Collateral inventory adjustment. This removes its quantity effect from inventory totals, together with any older scheduled reversal. Review the entry before deleting it; this action cannot be undone.
What deletion changes
The adjustment and its formatting saved in ExhibitDay, Logistical Records, related-item links and removable attachments are removed. Linked Tasks or other records themselves remain.
Removing an increase removes the stock it added; removing a decrease removes that reduction. Any inherited return date and its scheduled reversal are removed as well. A return date is not confirmation of a physical return.
Existing adjustments on archived items can be removed. Older adjustments outside the editing range can also be removed if the resulting totals stay in range. The API refuses deletion if a resulting stored total would fall outside the supported whole-number range. Negative totals are permitted.
Content that cannot be removed
The key must be allowed to remove the entry’s associated content. If content cannot safely be removed, the action refuses the request without deleting the adjustment. It does not grant access to another workspace’s Event information.
Review any restricted content in ExhibitDay with an authorized account before deciding how to proceed. A stored file still referenced elsewhere is kept; later file-cleanup failure does not undo a confirmed deletion.
Deleting only an unchanged adjustment
If the adjustment, its formatting saved in ExhibitDay, Logistical Records or related-item links changed since your read, the API returns HTTP 409 with error_code=record_changed and deletes nothing. Retrieve the adjustment again and decide whether to delete it. A value that changed and was later changed back still matches.
A blank, null or malformed revision, or different revision values sent in the same request, returns HTTP 400 with error_code=invalid_request. Omit expected_revision to delete without this check. A successful deletion returns no new revision, because the adjustment no longer exists.
- Retrieve the adjustment with
GET /v1/assets/inventory_adjustments/infoand set$include_record_revision=true. - In your DELETE request, set
expected_revisionto the exactrecord_revisionreturned by GET.
Retrying a deletion
This method ignores the Idempotency-Key header. If the save outcome cannot be confirmed, retrieve the adjustment and check inventory before retrying. The API does not automatically repeat the deletion.
A confirmed deletion is added to history. A history-writing failure does not undo it. Deletion sends no follower or business notifications.
curl -X DELETE "https://api.exhibitday.com/v1/assets/inventory_adjustments?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/assets/inventory_adjustments?" + new URLSearchParams({ "id": "12345" }), {
method: "DELETE",
headers: { "Authorization": "Bearer YOUR_API_KEY" }
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.delete(
"https://api.exhibitday.com/v1/assets/inventory_adjustments",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"id": 12345},
)
print(response.status_code, response.json())
using System;
using System.Net.Http;
using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var response = await client.DeleteAsync("https://api.exhibitday.com/v1/assets/inventory_adjustments?id=12345");
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ExhibitDayExample {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.exhibitday.com/v1/assets/inventory_adjustments?id=12345"))
.header("Authorization", "Bearer YOUR_API_KEY")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}
<?php
$curl = curl_init('https://api.exhibitday.com/v1/assets/inventory_adjustments?id=12345');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'DELETE',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($curl);
if ($response === false) {
throw new RuntimeException(curl_error($curl));
}
echo curl_getinfo($curl, CURLINFO_HTTP_CODE) . PHP_EOL . $response;
curl_close($curl);
require 'net/http'
require 'uri'
uri = URI('https://api.exhibitday.com/v1/assets/inventory_adjustments?id=12345')
request = Net::HTTP::Delete.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
http.request(request)
end
puts "#{response.code} #{response.body}"
package main
import (
"fmt"
"io"
"log"
"net/http"
)
func main() {
request, err := http.NewRequest("DELETE", "https://api.exhibitday.com/v1/assets/inventory_adjustments?id=12345", nil)
if err != nil { log.Fatal(err) }
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := (&http.Client{}).Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close()
body, err := io.ReadAll(response.Body)
if err != nil { log.Fatal(err) }
fmt.Printf("%d %s\n", response.StatusCode, body)
}
Example response
{
"status_code": 200,
"status": "OK",
"message": "Inventory Adjustment removed.",
"errors": []
}
{
"status_code": 400,
"status": "Bad Request",
"message": "HTTP method override is not supported.",
"error_code": "invalid_request",
"errors": [
"Send the documented HTTP method directly. X-HTTP-Method-Override cannot change a request's HTTP method."
],
"error_params": [
"X-HTTP-Method-Override"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "No API key was provided. Send your key in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "missing_api_key",
"errors": [
"Copy the key from Workspace Settings > API & Integrations > API Access in ExhibitDay."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "The API key is not valid. Check that you copied the whole key from Workspace Settings > API & Integrations > API Access, then send it in the Authorization header as 'Bearer YOUR_API_KEY'. Alternatively, you can use the api_key parameter.",
"error_code": "invalid_api_key",
"errors": [
"Check that you sent the whole key. If it was regenerated, use the current key from Workspace Settings > API & Integrations > API Access."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 401,
"status": "Unauthorized",
"message": "Access to the ExhibitDay API is not enabled for your workspace. Please contact support@exhibitday.com to enable API Access. Once access is enabled, send your key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "api_access_disabled",
"errors": [
"Nothing was read or changed."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Inventory Adjustment not found. Invalid Inventory Adjustment ID: 12345.",
"error_code": "not_found",
"errors": [
"Inventory Adjustment not found. Invalid Inventory Adjustment ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "This adjustment changed since you read it; nothing was changed.",
"error_code": "record_changed",
"errors": [
"This adjustment changed since you read it; nothing was changed."
],
"error_params": [
"expected_revision"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The inventory adjustment or its content changed while the request was being saved. Read it again before deciding whether to retry; nothing was changed.",
"error_code": "record_changed",
"errors": [
"The inventory adjustment or its content changed while the request was being saved. Read it again before deciding whether to retry; nothing was changed."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 429,
"status": "Too Many Requests",
"message": "Error 429 - Too Many Requests",
"error_code": "rate_limited",
"errors": [
"Error 429 - Too Many Requests"
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"An unexpected error occurred. Please try again later."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 500,
"status": "Unexpected Internal Error",
"message": "An unexpected error occurred. Please try again later.",
"error_code": "internal_error",
"errors": [
"Check whether your change was saved before trying again."
],
"error_params": [],
"request_id": "0123456789abcdef0123456789abcdef"
}