> To build or manage a Wix site with an AI agent, follow https://www.wix.com/headless/skill.md
> It builds a new Wix site or puts your own site online, from a prompt, and keeps changing it afterwards. The pages are code in any web technology, and Wix runs the backend.
> It works through the Wix plugin (the Wix MCP and the Wix skills), the Wix CLI or no Wix login, and puts the site live on Wix hosting or on another host.
> Business features include a store, bookings, events and tickets, a restaurant, a blog, forms, members and many more.
> Read the Wix skills online at https://www.wix.com/skills
> 
> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# BulkUpdateTickets

# Package: ticketing

# Namespace: TicketManagement

# Method link: https://dev.wix.com/docs/api-reference/business-solutions/events/registration/ticketing/tickets/bulk-update-tickets?apiView=SDK.md

## Permission Scopes:
Manage Guest List: SCOPE.DC-EVENTS.MANAGE-GUEST-LIST

## Introduction

Updates the `archived` state of multiple tickets.

---

## REST API

### Schema

```
 Method: bulkUpdateTickets
 Description: Updates the `archived` state of multiple tickets.
 URL: https://www.wixapis.com/events/v1/tickets
 Method: PATCH
 Method parameters:
   param name: archived | type: archived | description: Whether tickets are archived.  
   param name: eventId | type: eventId | description: Event GUID to which the tickets belong.  | validation: format GUID
   param name: ticketNumber | type: array<ticketNumber> | description: Unique ticket numbers.  | validation: minItems 1, maxItems 100, minLength 1, maxLength 36
 Return type: BulkUpdateTicketsResponse
  - name: tickets | type: array<Ticket> | description: Updated tickets.  
     - name: ticketNumber | type: string | description: Unique ticket number which is assigned automatically when creating a ticket.  
     - name: orderNumber | type: string | description: Associated order number.  
     - name: ticketDefinitionId | type: string | description: Ticket definition GUID. See the Ticket Definition API for additional information.  | validation: format GUID
     - name: name | type: string | description: Ticket type.  
     - name: price | type: Money | description: Ticket price.  
        - name: currency | type: string | description: 3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. For example, `USD`.  | validation: format CURRENCY
        - name: value | type: string | description: Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, starts with a single (-), to indicate that the amount is negative.  | validation: format DECIMAL_VALUE
     - name: free | type: boolean | description: Whether the ticket requires payment.  | read-only: true 
     - name: policy | type: string | description: Ticket and event policies.  
     - name: checkIn | type: CheckIn | description: Ticket check-in.  
        - name: created | type: string | description: Time of a ticket's check-in.  | validation: format date-time
     - name: orderStatus | type: OrderStatus | description: Associated order status.  
         - enum:
         -     NA_ORDER_STATUS: Order status isn't available for this request fieldset.
         -     FREE: Order is confirmed, no payment is required.
         -     PENDING: Order was paid, but the payment gateway suspended the payment.
         -     PAID: Order is paid.
         -     OFFLINE_PENDING: Order is confirmed but must be paid via offline payment. Status needs to be manually updated to `"PAID"`.
         -     INITIATED: Order is waiting for payment at the cashier.
         -     CANCELED: Order is canceled.
         -     DECLINED: Order payment is declined.
         -     AUTHORIZED: Order payment is authorized.
         -     VOIDED: Order payment is voided.
         -     PARTIALLY_PAID: Order is partially paid with less than the total amount.
     - name: orderArchived | type: boolean | description: Whether the order and ticket are archived. If set to `true`, they aren't visible in the order list.  
     - name: orderFullName | type: string | description: Buyer full name.  
     - name: guestFullName | type: string | description: Guest full name.  
     - name: guestDetails | type: GuestDetails | description: Guest personal details.  
        - name: guestAssigned | type: boolean | description: Whether ticket belongs to assigned guest.  
        - name: firstName | type: string | description: Guest first name.  
        - name: lastName | type: string | description: Guest last name.  
        - name: email | type: string | description: Guest email.  | validation: format EMAIL
        - name: form | type: FormResponse | description: Full form response.  
           - name: inputValues | type: array<InputValue> | description: Form field inputs.  | validation: maxItems 200
              - name: inputName | type: string | description: Form field input name.  | validation: maxLength 100
              - name: value | type: string | description: Form field value.  | validation: maxLength 5000
              - name: values | type: array<string> | description: Form field values.  | validation: maxItems 100, maxLength 5000
        - name: contactId | type: string | description: Contact GUID associated with this guest.  | validation: format GUID
        - name: phone | type: string | description: Guest phone number.  | validation: format PHONE
     - name: archived | type: boolean | description: Whether the ticket is visible in an order.  
     - name: memberId | type: string | description: Ticket owner member GUID.  | validation: format GUID
     - name: anonymized | type: boolean | description: Whether ticket was anonymized by GDPR delete. Anonymized tickets no longer contain personally identifiable information (PII).  
     - name: checkInUrl | type: string | description: Ticket check-in URL.  Shown as QR code image in PDF.  <br/> Format: `"https://www.wixevents.com/check-in/{ticket number},{event id}"`  <br/> Example: `"https://www.wixevents.com/check-in/AAAA-AAAA-BB021,00000000-0000-0000-0000-000000000000"`  
     - name: ticketPdfUrl | type: string | description: URL for ticket PDF download.  
     - name: channel | type: ChannelType | description: Associated order checkout channel type.  
         - enum:
         -     ONLINE: Buyer created the order via an online channel, such as a website or mobile app.
         -     OFFLINE_POS: Sales person created the order and collected the money.
     - name: walletPassUrl | type: string | description: URL to download a ticket in `.pkpass` format for Apple Wallet.  | read-only: true | validation: format WEB_URL
     - name: canceled | type: boolean | description: Whether ticket is canceled.  | read-only: true 


```

### Examples

### BulkUpdateTickets
```curl
~~~cURL
curl -X PATCH 'https://www.wixapis.com/events/v1/tickets' \
-H 'Content-Type: application/json' \
-H 'Authorization: <AUTH TOKEN>' \
-d '{
  "eventId": "ad18d12e-a6a9-4c17-abfa-6ff119479be2",
  "ticketNumber": [
    "FNVL-NIJT-WP021",
    "FNVL-O7MZ-0Q021"
  ],
  "archived": true
}'
~~~
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.events.tickets.bulkUpdateTickets(options)
 Description: Updates the `archived` state of multiple tickets.
 Method parameters:
   param name: options | type: BulkUpdateTicketsOptions  none  
        - name: eventId | type: string | description: Event GUID to which the tickets belong.  | validation: format GUID
        - name: ticketNumber | type: array<string> | description: Unique ticket numbers.  | validation: minItems 1, maxItems 100, minLength 1, maxLength 36
        - name: archived | type: boolean | description: Whether tickets are archived.  
 Return type: PROMISE<BulkUpdateTicketsResponse>
  - name: tickets | type: array<Ticket> | description: Updated tickets.  
     - name: ticketNumber | type: string | description: Unique ticket number which is assigned automatically when creating a ticket.  
     - name: orderNumber | type: string | description: Associated order number.  
     - name: ticketDefinitionId | type: string | description: Ticket definition GUID. See the Ticket Definition API for additional information.  | validation: format GUID
     - name: name | type: string | description: Ticket type.  
     - name: price | type: Money | description: Ticket price.  
        - name: currency | type: string | description: 3-letter currency code in [ISO-4217 alphabetic](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) format. For example, `USD`.  | validation: format CURRENCY
        - name: value | type: string | description: Monetary amount. Decimal string with a period as a decimal separator (e.g., 3.99). Optionally, starts with a single (-), to indicate that the amount is negative.  | validation: format DECIMAL_VALUE
     - name: free | type: boolean | description: Whether the ticket requires payment.  | read-only: true 
     - name: policy | type: string | description: Ticket and event policies.  
     - name: checkIn | type: CheckIn | description: Ticket check-in.  
        - name: created | type: Date | description: Time of a ticket's check-in.  
     - name: orderStatus | type: OrderStatus | description: Associated order status.  
         - enum:
         -     NA_ORDER_STATUS: Order status isn't available for this request fieldset.
         -     FREE: Order is confirmed, no payment is required.
         -     PENDING: Order was paid, but the payment gateway suspended the payment.
         -     PAID: Order is paid.
         -     OFFLINE_PENDING: Order is confirmed but must be paid via offline payment. Status needs to be manually updated to `"PAID"`.
         -     INITIATED: Order is waiting for payment at the cashier.
         -     CANCELED: Order is canceled.
         -     DECLINED: Order payment is declined.
         -     AUTHORIZED: Order payment is authorized.
         -     VOIDED: Order payment is voided.
         -     PARTIALLY_PAID: Order is partially paid with less than the total amount.
     - name: orderArchived | type: boolean | description: Whether the order and ticket are archived. If set to `true`, they aren't visible in the order list.  
     - name: orderFullName | type: string | description: Buyer full name.  
     - name: guestFullName | type: string | description: Guest full name.  
     - name: guestDetails | type: GuestDetails | description: Guest personal details.  
        - name: guestAssigned | type: boolean | description: Whether ticket belongs to assigned guest.  
        - name: firstName | type: string | description: Guest first name.  
        - name: lastName | type: string | description: Guest last name.  
        - name: email | type: string | description: Guest email.  | validation: format EMAIL
        - name: form | type: FormResponse | description: Full form response.  
           - name: inputValues | type: array<InputValue> | description: Form field inputs.  | validation: maxItems 200
              - name: inputName | type: string | description: Form field input name.  | validation: maxLength 100
              - name: value | type: string | description: Form field value.  | validation: maxLength 5000
              - name: values | type: array<string> | description: Form field values.  | validation: maxItems 100, maxLength 5000
        - name: contactId | type: string | description: Contact GUID associated with this guest.  | validation: format GUID
        - name: phone | type: string | description: Guest phone number.  | validation: format PHONE
     - name: archived | type: boolean | description: Whether the ticket is visible in an order.  
     - name: memberId | type: string | description: Ticket owner member GUID.  | validation: format GUID
     - name: anonymized | type: boolean | description: Whether ticket was anonymized by GDPR delete. Anonymized tickets no longer contain personally identifiable information (PII).  
     - name: checkInUrl | type: string | description: Ticket check-in URL.  Shown as QR code image in PDF.  <br/> Format: `"https://www.wixevents.com/check-in/{ticket number},{event id}"`  <br/> Example: `"https://www.wixevents.com/check-in/AAAA-AAAA-BB021,00000000-0000-0000-0000-000000000000"`  
     - name: ticketPdfUrl | type: string | description: URL for ticket PDF download.  
     - name: channel | type: ChannelType | description: Associated order checkout channel type.  
         - enum:
         -     ONLINE: Buyer created the order via an online channel, such as a website or mobile app.
         -     OFFLINE_POS: Sales person created the order and collected the money.
     - name: walletPassUrl | type: string | description: URL to download a ticket in `.pkpass` format for Apple Wallet.  | read-only: true | validation: format WEB_URL
     - name: canceled | type: boolean | description: Whether ticket is canceled.  | read-only: true 


```

### Examples

### bulkUpdateTickets
```javascript
import { tickets } from '@wix/events';

async function bulkUpdateTickets(options) {
  const response = await tickets.bulkUpdateTickets(options);
};
```

### bulkUpdateTickets (with elevated permissions)
```javascript
import { tickets } from '@wix/events';
import { auth } from '@wix/essentials';

async function myBulkUpdateTicketsMethod(options) {
  const elevatedBulkUpdateTickets = auth.elevate(tickets.bulkUpdateTickets);
  const response = await elevatedBulkUpdateTickets(options);
}
```

### bulkUpdateTickets (self-managed)
Self-managed SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { tickets } from '@wix/events';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { tickets },
  // Include the auth strategy and host as relevant
});


async function bulkUpdateTickets(options) {
  const response = await myWixClient.tickets.bulkUpdateTickets(options);
};
```

---