# Plan Next Year's Show by Copying Last Year's Event

> Copy last year's Event into a new Event for next year's show, choose what comes along, then set its Exhibit Hall dates and review the copied Tasks.

This is the Markdown copy of https://api.exhibitday.com/Help/V1?guide=copy-event-next-year for AI tools. Code examples are in curl, JavaScript, Python and C#; the help page shows all 8 languages, and https://api.exhibitday.com/llms-full.txt has the complete reference in one file. Index of all pages: https://api.exhibitday.com/llms.txt

Copy last year's Event into a new Event for next year's show, choose what comes along, then set its Exhibit Hall dates and review the copied Tasks.

Example use case

Sample Expo comes around every March. You want next year's Event with the same Tasks, Task Sections and Event Information, without retyping last year's plan.

What you'll end up with

A new Event for next year, a mapping from each of last year's Tasks to its copy, and the Exhibit Hall dates you set.

Before you start

Have a workspace API key, last year's Event name and next year's show dates. Your workspace plan must include Copy/Duplicate Event.

Good to know

Last year's Event stays as it is. By default the copy brings Event Information and Tasks. You choose anything else.

## At a glance

Time to try

About 15 minutes

Effect on your data

Creates records

Endpoints

5

The example creates one Event with copies of last year's Event Information and Tasks. It sends `notify=false`, so nobody gets an email. Step 3 replaces the new Event's Exhibit Hall dates.

- [`GET /v1/events`](https://api.exhibitday.com/Help/V1?epf=1#get-v1-events)
- [`POST /v1/events/copy`](https://api.exhibitday.com/Help/V1?epf=1#post-v1-events-copy)
- [`GET /v1/events/dates`](https://api.exhibitday.com/Help/V1?epf=1#get-v1-events-dates)
- [`PATCH /v1/events/dates`](https://api.exhibitday.com/Help/V1?epf=1#patch-v1-events-dates)
- [`GET /v1/tasks`](https://api.exhibitday.com/Help/V1?epf=2#get-v1-tasks)

## How it works

1. Find last year's Event by name and year.
2. Copy it into a new Event with next year's name and dates.
3. Set the new Event's Exhibit Hall dates, then review the copied Tasks.

## Copy the Event or copy Tasks?

|  | This guide: Copy/Duplicate Event | Copy Tasks from a Previous Event |
| --- | --- | --- |
| Request | `POST /v1/events/copy` | `POST /v1/tasks/import_from_event` |
| Creates | A new Event | Nothing new except Tasks, in an Event you already have |
| Copies | Event Information and Tasks by default. Booth, Staff, Travel, Shipments, Giveaways, Sponsorships, Playbook, Misc. Expenses & Credits, Budget, Objectives and your Special tab when you ask. | Selected Tasks only |
| Task Sections | Copied with the Tasks | Left behind. You choose one target section. |

Use [Copy Tasks from a Previous Event](https://api.exhibitday.com/Help/V1?guide=reuse-event-plan) when next year's Event exists, for example because your CRM created it.

## Copy the Event and finish setting it up

## Step 1: Find last year's Event

Search by part of the name and the year the show started. This example looks for `Sample Expo` in 2026.

```bash
curl -X GET "https://api.exhibitday.com/v1/events?filter_by_event_name_contains_text=Sample%20Expo&filter_by_event_start_date_category=2026&%24return_event_lites=true" -H "Authorization: Bearer YOUR_API_KEY"
```

**Example response (shortened)**

```json
{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_data": [
    {
      "id": 12345,
      "name": "Sample Event",
      "start_date": "2026-11-20",
      "end_date": "2026-11-22",
      "participation_type": "Committed"
    }
  ]
}
```

**Check:** Keep the `id` of the one Event you mean. A year in `filter_by_event_start_date_category` finds Events that start in that year. To search a date range instead, use `filter_by_start_date_greater_than_or_equal_to` and `filter_by_start_date_smaller_than_or_equal_to` and leave the category out.

## Step 2: Copy the Event

Send last year's Event ID, next year's name and dates, and the parts you want. Add the header `Idempotency-Key: YOUR_UNIQUE_KEY` so a retry can reuse the original result.

```bash
curl -X POST "https://api.exhibitday.com/v1/events/copy" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"event_id\":12345,\"name\":\"Sample Expo 2027\",\"start_date\":\"2027-03-09\",\"end_date\":\"2027-03-11\",\"copy_tasks\":true,\"task_due_date_mode\":\"same_offset\",\"notify\":false}"
```

**Example response (shortened)**

```json
{
  "source_event_id": 12345,
  "id": 23456,
  "name": "Sample Expo 2027",
  "start_date": "2027-03-09",
  "end_date": "2027-03-11",
  "tasks_copied": 1,
  "files_queued": 0,
  "files_skipped": 0,
  "tasks": [
    {
      "source_task_id": 34567,
      "id": 45678,
      "exhibitday_url": "https://www.exhibitday.com/Workspace/TaskView/98765?tid=45678"
    }
  ]
}
```

Choose what to copy. The labels are the ones in the website's Copy/Duplicate Event dialog.

| Option | Website label | Default | What it copies |
| --- | --- | --- | --- |
| `name` | Event Name | `Copy of` and last year's name | The new Event's name. |
| `start_date`, `end_date` | Event Dates | Last year's dates | Send both as `YYYY-MM-DD`, or neither. |
| `participation_type_id` | Participation Status | Last year's status | Committed, Considering, Not Going or a custom status. If last year's status is no longer available, the copy uses Considering. IDs come from `GET /v1/references/event_participation_types`. |
| `copy_info` | Copy data under the “Event Information” tab | `true` | Information fields, their saved documents and custom fields. |
| `copy_info_dates` | Include Exhibit Hall dates/times and Booth Setup and Dismantle dates/times (not recommended) | `false` | Last year's Exhibit Hall, Booth Setup and Booth Dismantle dates, unchanged. Leave it off and set next year's in Step 3. |
| `copy_tasks` | Copy Tasks | `true` | Tasks, their Task Sections and saved attachments. Copies start Incomplete, with no comments. |
| `keep_task_assignees` | Assign the new/copied tasks to the same assignees as the current tasks | `false` | Keeps Assignees and tagged Contributors. The default leaves the copies unassigned. |
| `task_due_date_mode` | Assign due dates to the new/copied tasks | `none` | `none` leaves Due Dates empty. `same_offset` keeps each Task the same number of days from the Event start date. `same_date` keeps last year's exact dates. |
| `copy_booth` (and `copy_booth_costs`) | Copy data under the event “Booth” tab (Include booth/booth Service costs and invoices) | `false` | Booth details and Booth Services (and their costs, payment details and invoices). |
| `copy_staff` (and `copy_staff_costs`) | Copy event Attendees (Include attendee registration costs and invoices) | `false` | Attendee / Registration records (and their costs). |
| `copy_travel` (and `copy_travel_costs`) | Copy Travel Reservations | `false` | Travel Reservations (and their costs). |
| `copy_shipments` (and `copy_shipments_costs`) | Copy Shipments | `false` | Shipments and their Shipment Components (and their costs). |
| `copy_giveaways` (and `copy_giveaways_costs`) | Copy Giveaways | `false` | Giveaways (and their costs). |
| `copy_sponsorships` (and `copy_sponsorships_costs`) | Copy Sponsorships | `false` | Sponsorships (and their costs). |
| `copy_playbook` (and `copy_playbook_costs`) | Copy Playbook | `false` | Playbook Activities (and their costs). |
| `copy_misc_expenses_credits` (and `copy_misc_expenses_credits_costs`) | Copy Misc. Expenses & Credits | `false` | Misc. Expenses & Credits (and their amounts). |
| `copy_budget` | Copy Budget | `false` | Budget amounts and budget notes. |
| `copy_objectives` (and `copy_objective_scores`) | Copy Objectives (Copy the specified achievement ratings for the objectives, and the notes (not recommended)) | `false` | Objectives and priorities (and last year's achievement ratings and notes). |
| `copy_special_tab` | Copy (your Special tab's name) | `false` | Your Special tab's custom fields. |
| `notify` | (none) | `true` | `true` emails the people tagged on the copied records once, according to their email preferences, as the website does after Copy/Duplicate Event. `false` sends no email. |

Each `_costs` option applies only when its area is copied. The Event's General Attachments and invoice attachments aren't copied.

**Check:** Save the new Event `id` and each `source_task_id` with its new `id`. Each `files` entry is `queued` (the new file's `id`) or `skipped` (with a `reason`).

## Step 3: Set next year's Exhibit Hall dates

Read the new Event's Exhibit Hall dates with a revision.

```bash
curl -X GET "https://api.exhibitday.com/v1/events/dates?event_id=23456&filter_by_date_type_id=1&%24include_record_revision=true" -H "Authorization: Bearer YOUR_API_KEY"
```

Then replace the whole list. Send `expected_revision` set to the `record_revision` from your read, in place of `YOUR_RECORD_REVISION`.

```bash
curl -X PATCH "https://api.exhibitday.com/v1/events/dates" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"event_id\":23456,\"date_type_id\":1,\"dates\":[{\"date\":\"2027-03-09\",\"start_time\":\"10:00\",\"end_time\":\"17:00\",\"timezone\":\"EST\",\"description\":\"Exhibit hours\"}],\"expected_revision\":\"YOUR_RECORD_REVISION\"}"
```

**Check:** The list is replaced as a whole, so send every Exhibit Hall day. Use `date_type_id` `2` for Booth Setup or `3` for Booth Dismantle. If you get `record_changed` (HTTP 409), read the dates again before sending another update. See [Set an Event's Exhibit Hall Dates and Hours](https://api.exhibitday.com/Help/V1?guide=dates-times-time-zones) for the details.

## Step 4: Review the copied Tasks

List the new Event's Tasks and compare them with the mapping from Step 2.

```bash
curl -X GET "https://api.exhibitday.com/v1/tasks?filter_by_event_id=23456&%24return_task_lites=true&%24limit=50&%24offset=0" -H "Authorization: Bearer YOUR_API_KEY"
```

**Example response (shortened)**

```json
{
  "records_found": 1,
  "total_records": 1,
  "has_more": false,
  "list_data": [
    {
      "id": 12345,
      "name": "Sample task",
      "due_date": null,
      "is_completed": false
    }
  ]
}
```

**Check:** `total_records` should equal `tasks_copied`. With `same_offset`, a Task due 14 days before last year's show is due 14 days before next year's. While `has_more` is true, ask for the next page with the same filters and add 50 to `$offset`.

## Try it

## Before running the example

| Value | What to put in it |
| --- | --- |
| `YOUR_API_KEY` | Your workspace API key. Keep it out of shared code and logs. |
| `event_id` | Last year's Event ID, from Step 1. The example uses `12345`. |
| `name` | The new Event's name. The example uses `Sample Expo 2027`. |
| `start_date` and `end_date` | Next year's show dates as `YYYY-MM-DD`. The example uses March 9 to 11, 2027. |
| `copy_tasks` and `task_due_date_mode` | The example copies the Tasks and keeps each Due Date the same number of days from the Event start date. |
| `notify` | The example sends `false`, so nobody gets an email. |

**Careful.** This example creates a new Event in your workspace. Copy a test Event first.

Copy the complete example in your language and run it. To try another step, change the request to match one of the steps above.

## Complete example program

Code Samples

```bash
curl -X POST "https://api.exhibitday.com/v1/events/copy" -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d "{\"event_id\":12345,\"name\":\"Sample Expo 2027\",\"start_date\":\"2027-03-09\",\"end_date\":\"2027-03-11\",\"copy_tasks\":true,\"task_due_date_mode\":\"same_offset\",\"notify\":false}"
```

```javascript
const response = await fetch("https://api.exhibitday.com/v1/events/copy", {
  method: "POST",
  headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ "event_id": 12345, "name": "Sample Expo 2027", "start_date": "2027-03-09", "end_date": "2027-03-11", "copy_tasks": true, "task_due_date_mode": "same_offset", "notify": false })
});
const data = await response.json();
console.log(response.status, data);
```

```python
import requests

response = requests.post(
    "https://api.exhibitday.com/v1/events/copy",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"event_id": 12345, "name": "Sample Expo 2027", "start_date": "2027-03-09", "end_date": "2027-03-11", "copy_tasks": True, "task_due_date_mode": "same_offset", "notify": False},
)
print(response.status_code, response.json())
```

```csharp
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/events/copy",
    JsonContent.Create(new { event_id = 12345, name = "Sample Expo 2027", start_date = "2027-03-09", end_date = "2027-03-11", copy_tasks = true, task_due_date_mode = "same_offset", notify = false }));
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
```

```java
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/events/copy"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString("{\"event_id\":12345,\"name\":\"Sample Expo 2027\",\"start_date\":\"2027-03-09\",\"end_date\":\"2027-03-11\",\"copy_tasks\":true,\"task_due_date_mode\":\"same_offset\",\"notify\":false}"))
            .build();
        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}
```

```php
<?php
$curl = curl_init('https://api.exhibitday.com/v1/events/copy');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"event_id":12345,"name":"Sample Expo 2027","start_date":"2027-03-09","end_date":"2027-03-11","copy_tasks":true,"task_due_date_mode":"same_offset","notify":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);
```

```ruby
require 'net/http'
require 'uri'

uri = URI('https://api.exhibitday.com/v1/events/copy')
request = Net::HTTP::Post.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'
request['Content-Type'] = 'application/json'
request.body = '{"event_id":12345,"name":"Sample Expo 2027","start_date":"2027-03-09","end_date":"2027-03-11","copy_tasks":true,"task_due_date_mode":"same_offset","notify":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}"
```

```go
package main

import (
    "fmt"
    "io"
    "log"
    "net/http"
    "strings"
)

func main() {
    request, err := http.NewRequest("POST", "https://api.exhibitday.com/v1/events/copy", strings.NewReader("{\"event_id\":12345,\"name\":\"Sample Expo 2027\",\"start_date\":\"2027-03-09\",\"end_date\":\"2027-03-11\",\"copy_tasks\":true,\"task_due_date_mode\":\"same_offset\",\"notify\":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

Response 200 — OK 400 — Bad Request 401 — Unauthorized 404 — Not Found 409 — Conflict 429 — Too Many Requests 500 — Internal Server Error

Example Successful request

```json
{
  "source_event_id": 12345,
  "id": 23456,
  "exhibitday_url": "https://www.exhibitday.com/Workspace/Event/98765?eid=23456",
  "name": "Sample Expo 2027",
  "start_date": "2027-03-09",
  "end_date": "2027-03-11",
  "tasks_copied": 1,
  "files_queued": 0,
  "files_skipped": 0,
  "tasks": [
    {
      "source_task_id": 34567,
      "id": 45678,
      "exhibitday_url": "https://www.exhibitday.com/Workspace/TaskView/98765?tid=45678"
    }
  ],
  "files": []
}
```

Note: POST /v1/events/copy - HTTP 200. The new Event and the mapping from each copied Task to its new Task. Keep the new Event's id for the next steps.

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "status_code": 400,
  "status": "Bad Request",
  "message": "Your workspace plan doesn't include copying Events.",
  "error_code": "not_allowed",
  "errors": [
    "Your workspace plan doesn't include copying Events."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 400,
  "status": "Bad Request",
  "message": "This API key's workspace permissions don't allow adding Events.",
  "error_code": "not_allowed",
  "errors": [
    "This API key's workspace permissions don't allow adding Events."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 400,
  "status": "Bad Request",
  "message": "This API key's workspace permissions don't allow viewing the source Event.",
  "error_code": "not_allowed",
  "errors": [
    "This API key's workspace permissions don't allow viewing the source Event."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "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": [
    "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_params": [
    "api_key"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 404,
  "status": "Not Found",
  "message": "Event not found. Invalid Event ID: 12345. Get a current ID from GET /v1/events.",
  "error_code": "not_found",
  "errors": [
    "Event not found. Invalid Event ID: 12345. Get a current ID from GET /v1/events."
  ],
  "error_params": [
    "event_id"
  ],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "status_code": 409,
  "status": "Conflict",
  "message": "The selected source Event content changed before it could be copied. Retrieve current values before retrying.",
  "error_code": "record_changed",
  "errors": [
    "The selected source Event content changed before it could be copied. Retrieve current values before retrying."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 409,
  "status": "Conflict",
  "message": "The source Event or its selected content is being changed right now. No new Event was created. Try again in a moment.",
  "error_code": "record_changed",
  "errors": [
    "The source Event or its selected content is being changed right now. No new Event was created. Try again in a moment."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "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"
}
```

```json
{
  "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"
}
```

```json
{
  "status_code": 500,
  "status": "Unexpected Internal Error",
  "message": "An unexpected error occurred. Please try again later.",
  "error_code": "internal_error",
  "errors": [
    "The Event copy was not completed. No new Event was committed."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 500,
  "status": "Unexpected Internal Error",
  "message": "An unexpected error occurred. Please try again later.",
  "error_code": "internal_error",
  "errors": [
    "The Event copy outcome could not be confirmed. Retrieve the current Events before deciding whether to retry; this request was not automatically repeated."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "status_code": 500,
  "status": "Unexpected Internal Error",
  "message": "An unexpected error occurred. Please try again later.",
  "error_code": "internal_error",
  "errors": [
    "The Event copy response could not be completed safely. Retrieve the current Events before deciding whether to retry."
  ],
  "error_params": [],
  "request_id": "0123456789abcdef0123456789abcdef"
}
```

```json
{
  "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"
}
```

Note: Use the request_id from your own response when contacting support.

```json
{
  "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"
}
```

The curl example uses Bash. Node.js needs version 18 or later (save as .mjs). Python uses Requests. C# needs a .NET 8 console project (Program.cs). Java needs Java 11 or later (ExhibitDayExample.java). PHP needs PHP with cURL. Ruby and Go use their standard libraries.

## Things to keep in mind

- Copied files are copied in the background. `queued` doesn't mean the file can be downloaded yet. A download can return `file_copy_pending` (HTTP 409) until copying finishes.
- If last year's Event is busy with another save, the copy returns `record_changed` (HTTP 409) and creates nothing. Try again in a moment with the same key.
- If you lose the response, retry the exact request with the same key. For 24 hours, a completed copy returns the saved response with `Idempotent-Replayed: true`. If the API returns `idempotency_key_indeterminate`, search for the new name (Step 1) before copying again.
- The website warns when another Event has a similar name on the same dates. Search for next year's name first so you don't create two.
- Your plan and access to each area still apply. Areas you can't read aren't copied.

## Related guides

- [Copy Tasks from a Previous Event](https://api.exhibitday.com/Help/V1?guide=reuse-event-plan)
- [Set an Event's Exhibit Hall Dates and Hours](https://api.exhibitday.com/Help/V1?guide=dates-times-time-zones)
- [Search Events by Name, Custom Field or Tag](https://api.exhibitday.com/Help/V1?guide=search-events)
- [Handle Errors and Retry Failed Requests](https://api.exhibitday.com/Help/V1?guide=errors-and-retries)
