POST

Ticket.SettingsUpdate

Update org ticket settings on user_detail: ticket_email_settings (Settings → Email) and/or ticket_completion_reason_settings (Settings → Completion Reasons enable). Requires manager permission. At least one of the two fields must be sent.

Permissions

User must be logged in with a valid bearer token.
Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

Runs the Ticket.SettingsUpdate function and returns JSON.

Push Service

Pushes event ticket.settings.updated to users who should see this change.

Automation

No automation is run for this function.

Special Instructions

Requires manager permission.
Send 0 or 1. Aliases: email → ticket_email_settings, completion_reason → ticket_completion_reason_settings.
When completion reasons are turned ON, use Ticket.CompletionReason* to manage the reason list.
ticket_email_settings controls email on ticket create (dashboard Email ON/OFF).

Required Parameters

No body parameters are required for this function.

Optional Parameters

Name	Type	Sample	What it gives
`ticket_email_settings` post	int	`1`	Email on create ON/OFF (0/1). Alias: email. Required if ticket_completion_reason_settings is omitted.
`ticket_completion_reason_settings` post	int	`1`	Enable completion reason selection on close (0/1). Alias: completion_reason. Required if ticket_email_settings is omitted.

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Ticket.SettingsUpdate",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "ticket_email_settings": "1",
        "ticket_completion_reason_settings": "0"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Ticket.SettingsUpdate",
    "url_domain": "https:\/\/{domain}\/app\/Ticket.SettingsUpdate"
}

Endpoint

POST /app/Ticket.SettingsUpdate
POST https://{user}.bull36.com/app/Ticket.SettingsUpdate
POST https://{domain}/app/Ticket.SettingsUpdate

Sample Output

{
    "success": 1,
    "message": "Success",
    "data": {
        "ticket_email_settings": 1,
        "ticket_completion_reason_settings": 0
    },
    "socket_event": "ticket.settings.updated"
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({ ticket_email_settings: '1', ticket_completion_reason_settings: '0' });
const res = await fetch('/app/Ticket.SettingsUpdate', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());

Error Example

{
    "success": 0,
    "message": "Missing required parameter: ticket_email_settings or ticket_completion_reason_settings"
}