User Invitations
Retrieve a Single Open Workspace Invitation by ID #
|
Sample Object
|
Retrieves a single open workspace invitation by its ID.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The invitation ID from the open invitation list, Info response or creation receipt.
|
|
| $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 | object |
| $include_record_revision | Boolean | No |
Set to true to include record_revision. Use that value as expected_revision when revoking or re-sending this invitation.
|
Default: false.
|
| $ignore_params_with_empty_values | Boolean | No |
Set to true to ignore optional blank values and JSON nulls. Required values still must be supplied; the text null is not ignored.
|
Good to know
Retrieves one open invitation, including its intended role, permissions and content restrictions. These are the invitation's saved settings; they do not change an existing workspace member's permissions.
Saved invitation settings
Admin invitations have no effective permission denials or content restrictions.
send_invitation_email shows the choice made when the invitation was created through the API. It is null for invitations sent from the web app (true after the API re-sent one whose inviter had left the workspace). It doesn't confirm that the email was delivered.
A revoked, used, missing or other workspace's invitation returns HTTP 404. invited_by is the person who sent the invitation, as a User Lite object. For invitations created through the API it is the ExhibitDay API object (no id or email), as it is for a web app invitation the API re-sent after its inviter left the workspace. It is null when the person who sent the invitation is no longer an active member of this workspace. Email links, verification codes and proof tokens are never returned.
Checking before revocation or Resend
Include $include_record_revision=true, then send the returned record_revision as expected_revision to DELETE on the invitation list path, or to POST /v1/workspace_settings/users/invitations/resend. The check covers the recipient, intended access, status and saved notification preference. It grants no permission and is not an email verification link.
curl -X GET "https://api.exhibitday.com/v1/workspace_settings/users/invitations/info?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/workspace_settings/users/invitations/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/workspace_settings/users/invitations/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/workspace_settings/users/invitations/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/workspace_settings/users/invitations/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/workspace_settings/users/invitations/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/workspace_settings/users/invitations/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/workspace_settings/users/invitations/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
{
"id": 12345,
"email": "events-admin@example.invalid",
"status_id": 1,
"status": "Pending",
"workspace_role_id": 1,
"workspace_role": "Admin",
"invited_by": {
"id": null,
"first_name": "ExhibitDay",
"last_name": "API",
"display_name": "ExhibitDay API",
"email": null,
"type": null,
"workspace_role": null,
"is_active": true
},
"invitation_created_timestamp": "2030-01-15T12:00:00",
"invitation_accepted_timestamp": null,
"permission_denials": [],
"content_restrictions": {
"only_my_events": false,
"only_my_travel": false,
"only_my_playbook": false,
"only_my_activity": false,
"only_accessible_related_items": false
},
"send_invitation_email": false
}
{
"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": "Invalid Invitation ID in id, sent in the query string. Use a valid Invitation ID from the open invitation list.",
"error_code": "invalid_request",
"errors": [
"Invalid Invitation ID in id, sent in the query string. Use a valid Invitation ID from the open invitation list."
],
"error_params": [
"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": 401,
"status": "Unauthorized",
"message": "The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "invalid_api_key",
"errors": [
"The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Invitation not found. Invalid Invitation ID: 12345.",
"error_code": "not_found",
"errors": [
"Invitation not found. Invalid Invitation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Invitation information could not be read at this time. Retrieve the invitations again.",
"error_code": "record_changed",
"errors": [
"Invitation information could not be read at this time. Retrieve the invitations again."
],
"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": [
"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 Open Workspace Invitations #
|
Retrieves open invitations to your workspace.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| filter_by_status | String | No |
Select one open status. Leave it out for both. Accepted means the person accepted the invitation but has not yet joined.
|
Allowed values:
pending | accepted |
| $limit | Number | No |
The most invitations to return, as a positive whole number. Omit it for all remaining matching invitations.
|
|
| $offset | Number | No |
How many matching invitations to skip: 0 or more. The default is 0.
|
|
| $result_sort | String | No |
Order invitations by their IDs. Omit for oldest first; request descending order for newest first. Unsupported choices are refused.
|
Allowed values:
id_asc | id_desc |
| $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 |
| $ignore_params_with_empty_values | Boolean | No |
Set to true to ignore optional blank values and JSON nulls. Required values still must be supplied; the text null is not ignored.
|
Good to know
Retrieves pending invitations and invitations accepted by people who have not yet joined your workspace. Invitations already used to join are excluded.
Invitation status
Retrieving invitations sends no email and creates no account or workspace membership. Use Invitation Info to inspect an invitation's intended access.
invited_by is the person who sent the invitation, as a User Lite object. For invitations created through the API it is the ExhibitDay API object (no id or email), as it is for a web app invitation the API re-sent after its inviter left the workspace. It is null when the person who sent the invitation is no longer an active member of this workspace. Verification codes, email links and proof tokens are never returned.
curl -X GET "https://api.exhibitday.com/v1/workspace_settings/users/invitations" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/workspace_settings/users/invitations", {
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/users/invitations",
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/users/invitations");
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/users/invitations"))
.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/users/invitations');
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/users/invitations')
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/users/invitations", 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": 2,
"total_records": 2,
"has_more": false,
"list_type": "workspace_invitation",
"list_data": [
{
"id": 12345,
"email": "events-admin@example.invalid",
"status_id": 1,
"status": "Pending",
"workspace_role_id": 1,
"workspace_role": "Admin",
"invited_by": {
"id": null,
"first_name": "ExhibitDay",
"last_name": "API",
"display_name": "ExhibitDay API",
"email": null,
"type": null,
"workspace_role": null,
"is_active": true
},
"invitation_created_timestamp": "2030-01-15T12:00:00",
"invitation_accepted_timestamp": null
},
{
"id": 12346,
"email": "events-team@example.invalid",
"status_id": 2,
"status": "Accepted, not yet joined",
"workspace_role_id": 2,
"workspace_role": "Team Member",
"invited_by": {
"id": null,
"first_name": "ExhibitDay",
"last_name": "API",
"display_name": "ExhibitDay API",
"email": null,
"type": null,
"workspace_role": null,
"is_active": true
},
"invitation_created_timestamp": "2030-01-15T12:00:00",
"invitation_accepted_timestamp": "2030-01-16T13:00:00"
}
]
}
{
"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": "The filter_by_status parameter in the query string is not valid. Allowed values: pending | accepted. Omit it for both.",
"error_code": "invalid_request",
"errors": [
"The filter_by_status parameter in the query string is not valid. Allowed values: pending | accepted. Omit it for both."
],
"error_params": [
"filter_by_status"
],
"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": 401,
"status": "Unauthorized",
"message": "The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "invalid_api_key",
"errors": [
"The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Invitation information could not be read at this time. Retrieve the invitations again.",
"error_code": "record_changed",
"errors": [
"Invitation information could not be read at this time. Retrieve the invitations again."
],
"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": [
"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"
}
Invite a User to Your Workspace #
|
Invites a person to your workspace with the access you choose.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| String | Yes |
The email address of the person to invite.
|
max length: 254
|
|
| workspace_role_id | Number | Yes |
Choose the intended workspace role. This choice is required.
|
Allowed values:
1 (Admin) | 2 (Team Member) | 3 (Guest) |
| send_invitation_email | Boolean | No |
Whether to email the invitation right away and send the automatic reminder. Default: true. Set it to false to save the invitation without those emails. You can still send it whenever you choose with Resend, through the API or in the web app; that sends the email without changing this preference.
|
Default: true.
|
| permission_denial_ids | JSON object/list | No |
Team Member or Guest only. A JSON array of the permission IDs to deny. Get the IDs, each role's defaults and the rules from GET /v1/references/permissions_and_content_restrictions. Omit it to use the role's defaults. [] denies nothing the role can choose; a Guest still never gets permissions that the Guest role doesn't offer.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
|
| content_restrictions | JSON object/list | No |
Team Member or Guest only. An object with any of only_my_events, only_my_travel, only_my_playbook, only_my_activity and only_accessible_related_items, each true or false. Leave a setting out for false. only_my_events, only_my_travel and only_my_playbook also turn on only_my_activity. only_my_travel and only_my_playbook need view access to Travel or Playbook. GET /v1/references/permissions_and_content_restrictions lists them with their rules.
View value format and limitsFile uploads use multipart form data. Other structured values use a JSON object or array; form/query values use JSON text.
|
|
| $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 | object |
| $ignore_params_with_empty_values | Boolean | No |
Set to true to ignore optional blank values and JSON nulls. Required values still must be supplied; the text null is not ignored.
|
|
| $request_principal_name | String | No |
Optional attribution label for API history, up to 122 characters. It does not impersonate a user or change the inviter.
|
|
| Idempotency-Key | String | No |
Optional request header. Reuse the same key and request to replay the original creation result instead of creating another invitation.
|
Good to know
Invites one person to your workspace and emails them the invitation right away. Set send_invitation_email to false to save the invitation without emailing it. The person joins after they accept the invitation and sign in or create an account; this request doesn't create an account or add them to the workspace.
Choosing access
Choose a role with workspace_role_id. Admins get every permission, so an Admin invitation can't include permission denials or content restrictions; [] and {} (or every setting false) are accepted because they restrict nothing.
For a Team Member or Guest, get the choices from GET /v1/references/permissions_and_content_restrictions. It follows the same rules as the invitation dialog in ExhibitDay for your workspace.
permission_denial_ids: omit it to use the role's defaults, send [] to deny nothing the role can choose, or send a list to deny exactly those permissions. A blank value or null is refused, unless $ignore_params_with_empty_values=true, which treats it as omitted. Leave content_restrictions out for no restrictions.
Some choices depend on others, as in ExhibitDay: denying a permission also denies the permissions that need it, permission 11 (tasks assigned only to self) is allowed whenever permission 10 (tasks for any user) is allowed, and only_my_events, only_my_travel or only_my_playbook also turn on only_my_activity. When this changes your request, the invitation is still created and the X-API-Warnings response header lists each change. A request ExhibitDay wouldn't allow, such as denying a permission your workspace doesn't use, is refused with HTTP 400 and nothing is saved.
Example: a Team Member with the role's defaults who also can't view Event Logs or the Activity Feed: {"email":"jordan@example.invalid","workspace_role_id":2,"permission_denial_ids":[1,2,3,12,19,31,32,35]}. Example: a Guest who sees only their own Travel Reservations: {"email":"jordan@example.invalid","workspace_role_id":3,"content_restrictions":{"only_my_travel":true,"only_my_activity":true}}.
The current workspace plan, available invitation slots, existing active members, open invitations, blocked email rules and workspace email-domain rules are checked before the invitation is saved. If a check fails, no invitation is created.
Email delivery
send_invitation_email defaults to true. false saves the invitation without the invitation email or automatic reminders. You can send the email later with Resend, through the API (POST /v1/workspace_settings/users/invitations/resend) or in the web app. That doesn't change the saved automatic-email preference.
The email is sent right away, as soon as the invitation is saved. If the invitation is saved but its email can't be sent, the request still succeeds and the X-API-Warnings response header says so; use Resend to send it again. A successful response doesn't confirm that the email was delivered. The response never includes the invitation link.
Retrying a request
If you can't tell whether the request succeeded, check the invitation list before you retry. Sending the same Idempotency-Key with the same request returns the original result instead of creating a second invitation.
curl -X POST "https://api.exhibitday.com/v1/workspace_settings/users/invitations" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"email\":\"jordan@example.invalid\",\"workspace_role_id\":2,\"send_invitation_email\":false}"
const response = await fetch("https://api.exhibitday.com/v1/workspace_settings/users/invitations", {
method: "POST",
headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ "email": "jordan@example.invalid", "workspace_role_id": 2, "send_invitation_email": false })
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.post(
"https://api.exhibitday.com/v1/workspace_settings/users/invitations",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"email": "jordan@example.invalid", "workspace_role_id": 2, "send_invitation_email": False},
)
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/workspace_settings/users/invitations",
JsonContent.Create(new { email = "jordan@example.invalid", workspace_role_id = 2, send_invitation_email = false }));
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/users/invitations"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"email\":\"jordan@example.invalid\",\"workspace_role_id\":2,\"send_invitation_email\":false}"))
.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/users/invitations');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"email":"jordan@example.invalid","workspace_role_id":2,"send_invitation_email":false}',
]);
$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/users/invitations')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"email":"jordan@example.invalid","workspace_role_id":2,"send_invitation_email":false}'
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/workspace_settings/users/invitations", strings.NewReader("{\"email\":\"jordan@example.invalid\",\"workspace_role_id\":2,\"send_invitation_email\":false}"))
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
{
"id": 12345,
"email": "jordan@example.invalid",
"status_id": 1,
"status": "Pending",
"workspace_role_id": 2,
"workspace_role": "Team Member",
"invited_by": {
"id": null,
"first_name": "ExhibitDay",
"last_name": "API",
"display_name": "ExhibitDay API",
"email": null,
"type": null,
"workspace_role": null,
"is_active": true
},
"invitation_created_timestamp": "2030-01-15T12:00:00",
"invitation_accepted_timestamp": null,
"permission_denials": [
{
"id": 1,
"name": "Illustrative permission definition"
},
{
"id": 2,
"name": "Illustrative permission definition"
},
{
"id": 3,
"name": "Illustrative permission definition"
},
{
"id": 12,
"name": "Illustrative permission definition"
},
{
"id": 19,
"name": "Illustrative permission definition"
},
{
"id": 31,
"name": "Illustrative permission definition"
},
{
"id": 32,
"name": "Illustrative permission definition"
}
],
"content_restrictions": {
"only_my_events": false,
"only_my_travel": false,
"only_my_playbook": false,
"only_my_activity": false,
"only_accessible_related_items": false
},
"send_invitation_email": false,
"record_revision": "r1:BLrTwWH3s2O3xSAKrlOoZLntkSOm1lCdxXTBpYiSg0g"
}
{
"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": "The email parameter in the JSON body is missing. Send the email address of the person to invite.",
"error_code": "invalid_request",
"errors": [
"The email parameter in the JSON body is missing. Send the email address of the person to invite."
],
"error_params": [
"email"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The email parameter in the JSON body is not a valid email address. Send one address of up to 254 characters.",
"error_code": "invalid_request",
"errors": [
"The email parameter in the JSON body is not a valid email address. Send one address of up to 254 characters."
],
"error_params": [
"email"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The workspace_role_id parameter in the JSON body is not valid. Allowed values: 1 (Admin) | 2 (Team Member) | 3 (Guest).",
"error_code": "invalid_request",
"errors": [
"The workspace_role_id parameter in the JSON body is not valid. Allowed values: 1 (Admin) | 2 (Team Member) | 3 (Guest)."
],
"error_params": [
"workspace_role_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "This workspace has no available user or invitation slots for this role.",
"error_code": "invalid_request",
"errors": [
"This workspace has no available user or invitation slots for this role."
],
"error_params": [
"workspace_role_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "This workspace has no available Admin invitation slots.",
"error_code": "invalid_request",
"errors": [
"This workspace has no available Admin invitation slots."
],
"error_params": [
"workspace_role_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The email parameter in the JSON body belongs to an active member of this workspace.",
"error_code": "invalid_request",
"errors": [
"The email parameter in the JSON body belongs to an active member of this workspace."
],
"error_params": [
"email"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "An open invitation already exists for the email parameter in the JSON body. Find it with GET /v1/workspace_settings/users/invitations, or revoke it before inviting again.",
"error_code": "invalid_request",
"errors": [
"An open invitation already exists for the email parameter in the JSON body. Find it with GET /v1/workspace_settings/users/invitations, or revoke it before inviting again."
],
"error_params": [
"email"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The email parameter in the JSON body is not an allowed email address. To control spam, ExhibitDay doesn't allow accounts with that email address or from that email provider. Use another email address.",
"error_code": "invalid_request",
"errors": [
"The email parameter in the JSON body is not an allowed email address. To control spam, ExhibitDay doesn't allow accounts with that email address or from that email provider. Use another email address."
],
"error_params": [
"email"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The email parameter in the JSON body uses an email domain this workspace doesn't send invitations to. Allowed domains: northwind.example.",
"error_code": "invalid_request",
"errors": [
"The email parameter in the JSON body uses an email domain this workspace doesn't send invitations to. Allowed domains: northwind.example."
],
"error_params": [
"email"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The workspace_role_id parameter in the JSON body is not valid for this invitation. This plan supports Admin invitations only.",
"error_code": "invalid_request",
"errors": [
"The workspace_role_id parameter in the JSON body is not valid for this invitation. This plan supports Admin invitations only."
],
"error_params": [
"workspace_role_id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 400,
"status": "Bad Request",
"message": "The content_restrictions parameter in the JSON body is not valid for this invitation. Content restrictions require access to their corresponding Travel or Playbook area.",
"error_code": "invalid_request",
"errors": [
"The content_restrictions parameter in the JSON body is not valid for this invitation. Content restrictions require access to their corresponding Travel or Playbook area."
],
"error_params": [
"content_restrictions"
],
"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": 401,
"status": "Unauthorized",
"message": "The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "invalid_api_key",
"errors": [
"The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"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": "Invitation settings are busy or changed. Retrieve current invitations before deciding whether to retry.",
"error_code": "record_changed",
"errors": [
"Invitation settings are busy or changed. Retrieve current invitations before deciding whether to retry."
],
"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": [
"The save outcome could not be confirmed. Retrieve current invitations before retrying; this request was not automatically retried."
],
"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"
}
Revoke a Pending Workspace Invitation #
|
Revokes a pending workspace invitation.
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 invitation ID from the open invitation list, Info response or creation receipt.
|
|
| expected_revision | String | No |
The record_revision from this invitation's Info response. Include it to revoke only if its recipient, intended access, status and notification preference still match that read. Omit it to skip this check.
|
Blank, null, malformed or conflicting copies return HTTP 400. A stale revision returns HTTP 409 and changes nothing. Successful removal returns no new revision because the invitation no longer exists.
|
| $request_principal_name | String | No |
Optional attribution label for API history, up to 122 characters. It does not impersonate a user or change the inviter.
|
Good to know
Revokes a pending workspace invitation. To revoke an accepted invitation, use Users & Permissions in the web app. This operation does not remove an existing member or change their permissions.
Avoiding a stale revocation
Optionally send the record_revision from the invitation's Info response or creation receipt as expected_revision. If the saved recipient, intended access or notification preference changed, the request returns HTTP 409 and changes nothing. If the invitation has since been accepted, the request returns HTTP 400; if it was used or revoked, it returns HTTP 404.
An invitation that is missing, revoked, already used or belongs to another workspace is unavailable. Successful revocation returns no new revision because the invitation no longer exists. Revocation sends no invitation email.
Retrying a request
If you cannot confirm whether revocation succeeded, retrieve the open invitation list or Invitation Info before retrying. This endpoint does not accept an Idempotency-Key header; a request that sends one is refused with HTTP 400.
curl -X DELETE "https://api.exhibitday.com/v1/workspace_settings/users/invitations?id=12345" -H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch("https://api.exhibitday.com/v1/workspace_settings/users/invitations?" + 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/workspace_settings/users/invitations",
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/workspace_settings/users/invitations?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/workspace_settings/users/invitations?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/workspace_settings/users/invitations?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/workspace_settings/users/invitations?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/workspace_settings/users/invitations?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": "Invitation revoked.",
"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": 400,
"status": "Bad Request",
"message": "The invitation with ID 12345 has already been accepted, so it can't be revoked through the API. To revoke it, use Users & Permissions in the web app.",
"error_code": "invalid_request",
"errors": [
"The invitation with ID 12345 has already been accepted, so it can't be revoked through the API. To revoke it, use Users & Permissions in the web app."
],
"error_params": [
"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": 401,
"status": "Unauthorized",
"message": "The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "invalid_api_key",
"errors": [
"The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Invitation not found. Invalid Invitation ID: 12345.",
"error_code": "not_found",
"errors": [
"Invitation not found. Invalid Invitation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The invitation changed. Retrieve its current record_revision before deciding whether to revoke it.",
"error_code": "record_changed",
"errors": [
"The invitation changed. Retrieve its current record_revision before deciding whether to revoke it."
],
"error_params": [
"expected_revision"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Invitation settings are busy or changed. Retrieve current invitations before deciding whether to retry.",
"error_code": "record_changed",
"errors": [
"Invitation settings are busy or changed. Retrieve current invitations before deciding whether to retry."
],
"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": [
"The save outcome could not be confirmed. Retrieve current invitations before retrying; this request was not automatically retried."
],
"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"
}
Re-send a Workspace Invitation #
|
Emails an open workspace invitation again.
| Name | Type | Required? | Description | Details |
|---|---|---|---|---|
| id | Number | Yes |
The invitation ID from the open invitation list, Info response or creation receipt.
|
|
| expected_revision | String | No |
The record_revision from this invitation's Info response. Include it to re-send the invitation only if its recipient, intended access, status and notification preference still match that read. Omit it to skip this check.
|
Blank, null, malformed or conflicting copies return HTTP 400. A stale revision returns HTTP 409, and nothing is changed or sent.
|
| $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 | object |
| $ignore_params_with_empty_values | Boolean | No |
Set to true to ignore optional blank values and JSON nulls. Required values still must be supplied; the text null is not ignored.
|
|
| $request_principal_name | String | No |
Optional attribution label for API history, up to 122 characters. It does not impersonate a user or change the inviter.
|
Good to know
Emails an open workspace invitation again, the same way Resend works in the web app. Returns the invitation as Invitation Info does, with its record_revision.
Which invitations can be re-sent
As in the web app, you can re-send a pending invitation or one the person accepted but hasn't yet used to join, whether it was created in the web app or through the API. If the invitation is missing, revoked, already used to join or belongs to another workspace, the request returns HTTP 404.
Optionally send the record_revision from the invitation's Info response as expected_revision. If the saved recipient, intended access or notification preference changed since then, the request returns HTTP 409 and nothing is changed or sent.
Email delivery
The email is sent right away. It is the same kind of email the person first got: an invitation sent from the web app gets the web app's invitation email, which names the person who invited them; an invitation created through the API gets the API's invitation email, which names no one.
Like Resend in the web app, it restarts the timing of the automatic reminder. It doesn't change the saved send_invitation_email preference (except as described below); when that is false, no automatic reminder follows.
In the web app, when the person who sent an invitation is no longer an active member of the workspace, whoever re-sends it becomes its inviter. The API follows the same rule: the invitation becomes one sent by the ExhibitDay API, like an invitation created through the API. invited_by then returns the ExhibitDay API object, send_invitation_email returns true and the email names no one.
If the email can't be sent, the request returns HTTP 500, the invitation is put back as it was (unless it changed again in the meantime) and nothing is added to the workspace history; try again later. A successful response doesn't confirm that the email was delivered. The response never includes the invitation link.
Retrying a request
Each successful request sends another email. If you can't tell whether a request succeeded, check the invitation's Info response before you retry. This endpoint does not accept an Idempotency-Key header; a request that sends one is refused with HTTP 400.
curl -X POST "https://api.exhibitday.com/v1/workspace_settings/users/invitations/resend" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"id\":12345}"
const response = await fetch("https://api.exhibitday.com/v1/workspace_settings/users/invitations/resend", {
method: "POST",
headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
body: JSON.stringify({ "id": 12345 })
});
const data = await response.json();
console.log(response.status, data);
import requests
response = requests.post(
"https://api.exhibitday.com/v1/workspace_settings/users/invitations/resend",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"id": 12345},
)
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/workspace_settings/users/invitations/resend",
JsonContent.Create(new { 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/workspace_settings/users/invitations/resend"))
.header("Authorization", "Bearer YOUR_API_KEY")
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("{\"id\":12345}"))
.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/users/invitations/resend');
curl_setopt_array($curl, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"id":12345}',
]);
$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/users/invitations/resend')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"id":12345}'
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/workspace_settings/users/invitations/resend", strings.NewReader("{\"id\":12345}"))
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
{
"id": 12345,
"email": "events-admin@example.invalid",
"status_id": 1,
"status": "Pending",
"workspace_role_id": 1,
"workspace_role": "Admin",
"invited_by": {
"id": null,
"first_name": "ExhibitDay",
"last_name": "API",
"display_name": "ExhibitDay API",
"email": null,
"type": null,
"workspace_role": null,
"is_active": true
},
"invitation_created_timestamp": "2030-01-15T12:00:00",
"invitation_accepted_timestamp": null,
"permission_denials": [],
"content_restrictions": {
"only_my_events": false,
"only_my_travel": false,
"only_my_playbook": false,
"only_my_activity": false,
"only_accessible_related_items": false
},
"send_invitation_email": false,
"record_revision": "r1:quAOUxQcrhS5HLeFZNDbOWCfDMNiZWoy8joJJuzxCqE"
}
{
"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": 401,
"status": "Unauthorized",
"message": "The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'.",
"error_code": "invalid_api_key",
"errors": [
"The API key is not valid for this request. Send your current key in the Authorization header as 'Bearer YOUR_API_KEY'."
],
"error_params": [
"api_key"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 404,
"status": "Not Found",
"message": "Invitation not found. Invalid Invitation ID: 12345.",
"error_code": "not_found",
"errors": [
"Invitation not found. Invalid Invitation ID: 12345."
],
"error_params": [
"id"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "The invitation changed. Retrieve its current record_revision before deciding whether to re-send it.",
"error_code": "record_changed",
"errors": [
"The invitation changed. Retrieve its current record_revision before deciding whether to re-send it."
],
"error_params": [
"expected_revision"
],
"request_id": "0123456789abcdef0123456789abcdef"
}
{
"status_code": 409,
"status": "Conflict",
"message": "Invitation settings are busy or changed. Retrieve current invitations before deciding whether to retry.",
"error_code": "record_changed",
"errors": [
"Invitation settings are busy or changed. Retrieve current invitations before deciding whether to retry."
],
"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": [
"The save outcome could not be confirmed. Retrieve current invitations before retrying; this request was not automatically retried."
],
"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"
}