Events (Admin)

Update ticket (Admin)

PUT/manage/events/:eventId/tickets/:ticketId

Update a ticket type. Requires the ticketsWrite permission. price and paymentType cannot be changed once sales have started.

AuthLogin required

Path parameters

eventIdstringrequired

Event ID or slug.

ticketIdstringrequired

Ticket ID.

Request body

namestringoptional

Ticket name. Up to 100 characters (surrounding whitespace is trimmed).

descriptionstringoptional

Description; up to 500 characters.

languagesLanguagesoptional

Localized name / description.

salesLimitnumberoptional

Sales limit; an integer of 0 or more. null means unlimited.

statusstringoptional

One of DRAFT / PUBLISHED / PRIVATE.

confirmUserBasicInfobooleanoptional

Whether to confirm basic profile info at purchase.

requiresApprovalbooleanoptional

Whether registration requires approval.

transferablebooleanoptional

Whether the ticket can be transferred.

invitationEnabledbooleanoptional

Whether invitations are enabled. It can only be set to true when the event's enabledReferralTree feature is on; sending true otherwise returns 400.

invitationTargetTicketIdstringoptional

Ticket ID issued through invitations; must belong to the same event. Required when invitationEnabled is true.

invitationMaxGenerations / invitationLimitnumberoptional

Invitation generation depth must be 1 or 2; the per-person invitation limit must be an integer of 1 or more.

invitationDiscountEnabled / invitationDiscountPercent / invitationDiscountAmountboolean | numberoptional

Invitation discount settings. When enabled, either percent (0–100) or amount (0 or more) is required. Discounts apply only when the target ticket is paid.

Notes

Invitation (referral) settings can only be specified when the event's enabledReferralTree feature is enabled. Because enabledReferralTree can only be turned on through the platform administration (admin) API, sending invitationEnabled: true for an event without it returns 400 (VALIDATION_ERROR).

Response

Returns Ticket.

Request
curl https://api.4s.link/manage/events/EVENT_ID/tickets/TICKET_ID \
-X PUT \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"name": "一般チケット(早割)",
"salesLimit": 300
}'
Example response
{
"id": "t1a2b3c4-...",
"name": "一般チケット",
"description": "...",
"price": 5000,
"paymentType": "PREPAID_STRIPE",
"salesLimit": 200,
"status": "PUBLISHED",
"confirmUserBasicInfo": true,
"requiresApproval": false,
"transferable": true,
"invitationEnabled": false,
"order": 0
}