Workspace Logs
Retrieve Workspace Logs #
|
Retrieves your workspace activity history.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| $limit | Number | No |
The most entries to return (a whole number of 1 or more). Leave it out to return all remaining matching entries.
|
|
| $offset | Number | No |
How many matching entries to skip (a whole number of 0 or more; 0 by default). Use this with $limit to read the next page.
|
|
| $result_sort | String | No |
Sort entries newest first (the default) or oldest first. The full saved timestamp is used, with the entry ID breaking ties in the same direction. Responses display whole seconds. Unsupported values are refused. Use the values exactly as shown (lowercase).
|
Allowed values:
create_timestamp_desc (newest first) | create_timestamp_asc (oldest first) |
| $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 |
| filter_by_actor_user_id | String | No |
Only include entries written by the user with this id. Treat the id as text. Older entries can match a former user without exposing their account information.
|
|
| filter_by_log_entry_contains_text | String | No |
Only include entries containing this text, up to 3,000 characters. The characters are matched as sent; they are not converted from HTML or treated as wildcards.
|
|
| filter_by_create_timestamp_greater_than_or_equal_to | String | No |
Include entries created at or after this timestamp. Filters use the whole seconds shown in responses, so a fractional lower bound starts at the next whole second.
|
|
| filter_by_create_timestamp_smaller_than_or_equal_to | String | No |
Include entries created at or before this timestamp, including every entry in its displayed second. It can't be earlier than the lower bound.
|
|
| filter_by_event_id | Number | No |
Only include entries filed under this Event id in your workspace history.
|
|
| filter_by_event_tab_id | Number | No |
Only include entries filed under this Event tab ID. GET /v1/references/event_tabs lists your workspace's tabs; the Presentations tab is accepted only where your workspace has it.
|
Allowed values:
1 (Info) | 2 (Booth) | 3 (Staff) | 4 (Travel) | 5 (Assets) | 6 (Shipments) | 7 (Sponsorships) | 8 (Tasks) | 9 (Playbook) | 10 (Attachments) | 11 (Misc. Expenses & Credits) | 12 (Budget) | 13 (ROI) | 14 (Event Settings) | 16 (Binder) | 17 (Copy Event) | 19 (Logs) | 20 (Delete Event) | 21 (Giveaways) | 22 (Special Tab, shown under your workspace's name for it) |
| filter_by_context_type | String | No |
Only return entries associated with the selected context. Omit to include all contexts. Workspace means an entry with none of the other associations; an entry can belong to more than one other context. Unsupported values are refused. Values are case-insensitive.
|
Allowed values:
workspace | event | task | asset | storage_location |
| filter_by_asset_id | Number | No |
Only include entries filed under this Asset id. Supply a positive whole number.
|
|
| filter_by_storage_location_id | Number | No |
Only include entries filed under this Storage Location id. Supply a positive whole number.
|
|
| filter_by_task_id | Number | No |
Only include entries filed under this Task id. Supply a positive whole number.
|
Good to know
Retrieves your workspace activity history. Use filters to find the entries you need.
What the history includes
Includes user-visible business history, including changes that do not appear in the Activity Feed. Internal diagnostics, impersonation activity, IP addresses, device details and security information are not included.
Each request reads the current history. Use these results to review activity; they are not a complete feed of record changes or deletions.
Filtering entries
When you supply several filters, an entry must match all of them. The total count and the returned page use those same filters.
Text searches match the characters you enter literally, without wildcard matching.
Asset, Storage Location and Task filters use the IDs saved with each history entry. You can combine them with the other filters.
Reading dates and times
Returned timestamps are in UTC and show whole seconds. Sorting uses the full saved timestamp, then the entry ID to break ties; entries showing the same second can still have a distinct order.
Timestamp filters use the displayed whole-second precision. An upper bound includes all entries in that displayed second. A fractional lower bound starts at the next whole second.
A filter value with a time-zone offset is converted to US Eastern time for comparison. A value without an offset is interpreted as US Eastern time.
Reading the actor
actor_user_id is the ID of the user who made the change. actor_display_name is the name saved with the entry at that time; it does not change if the user is renamed later.
Entries recorded by the API have a null actor_user_id and show the label saved with them, such as API.
curl -X GET "https://api.exhibitday.com/v1/workspace_settings/logs" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/workspace_settings/logs", {
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/workspace_settings/logs",
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/workspace_settings/logs");
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/workspace_settings/logs"))
.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/workspace_settings/logs');
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/workspace_settings/logs')
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/workspace_settings/logs", 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": "workspace_log",
"list_data": [
{
"id": 67890,
"log_entry_created_timestamp": "2026-01-02T08:04:05Z",
"actor_user_id": "11111111-2222-4333-8444-555555555555",
"actor_display_name": "Illustrative user",
"log_entry": "Illustrative user updated a workspace setting.",
"event_id": null,
"event_name": null,
"event_tab_id": 0,
"task_id": null,
"task_name": null,
"asset_id": null,
"asset_name": null,
"storage_location_id": null,
"storage_location_name": null
}
]
}
{
"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": 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"
}