Logs
Retrieve a Task's Logs #
|
Retrieve a Task's Logs
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| task_id | Number | Yes |
The ID of the Task whose history you want to retrieve. Use an ID from GET /v1/tasks.
|
|
| $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 recorded under this Event ID. Useful when the Task has moved between Events.
|
|
| 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) |
Good to know
Retrieves activity history recorded for a Task, including entries recorded while it belonged to an earlier Event. A Task with no matching history returns an empty list.
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.
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.
Task history
A Task keeps its history when it moves to another Event. Entries recorded before the move still show the earlier Event's ID and name. A deleted Task, or a Task in another workspace, returns HTTP 404.
curl -X GET "https://api.exhibitday.com/v1/tasks/history?task_id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/tasks/history?" + new URLSearchParams({ "task_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/tasks/history",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"task_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/tasks/history?task_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/tasks/history?task_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/tasks/history?task_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/tasks/history?task_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/tasks/history?task_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
{
"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 coordinator",
"log_entry": "Illustrative coordinator linked 1 related item(s) to task 'Prepare the display'.",
"event_id": 23456,
"event_name": "Illustrative owned Event",
"event_tab_id": 8,
"task_id": 12345,
"task_name": "Prepare the display",
"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": 400,
"status": "Bad Request",
"message": "Missing Task ID. Send a valid Task ID in task_id.",
"error_code": "invalid_request",
"errors": [
"Missing Task ID. Send a valid Task ID in task_id."
],
"error_params": [
"task_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "Invalid Task ID in task_id. Use a valid Task ID.",
"error_code": "invalid_request",
"errors": [
"Invalid Task ID in task_id. Use a valid Task ID."
],
"error_params": [
"task_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": "Task not found. Invalid Task ID: 12345.",
"error_code": "not_found",
"errors": [
"Task not found. Invalid Task ID: 12345."
],
"error_params": [
"task_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": [
"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"
}