POST

TicketCustomFields.Delete

Delete a ticket custom field definition from user_detail.ticket_extra_fields. Same as the trash icon on Ticket Custom Filed. For a field inside a group send name of the child, or edit_id + sub_edit_id. Requires owner or member-admin. Existing ticket custom_fields JSON values for that key are not rewritten.

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

  • Removes the requested TicketCustomFields record when the user has permission.

Push Service

Pushes event ticketcustomfields.deleted to users who should see this change.

Automation

No automation is run for this function.

Special Instructions

  • Send the bearer token on protected calls with Authorization: Bearer YOUR TOKEN.
  • Send parameters as POST body fields exactly as documented.

Required Parameters

No body parameters are required for this function.

Optional Parameters

NameTypeSampleWhat it gives
name
post
stringa-1731562297Field storage id to delete.
edit_id
post
int2Top-level index (dashboard data_id). Alias: data_id.
sub_edit_id
post
int0Child index when deleting inside a group. Alias: sub_data_id.

Authentication

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

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/TicketCustomFields.Delete",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "name": "a-1731562297"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/TicketCustomFields.Delete",
    "url_domain": "https:\/\/{domain}\/app\/TicketCustomFields.Delete"
}

Endpoint

POST /app/TicketCustomFields.Delete
POST https://{user}.bull36.com/app/TicketCustomFields.Delete
POST https://{domain}/app/TicketCustomFields.Delete

Sample Output

{
    "success": 1,
    "message": "Your Custom field Delete",
    "name": "a-1731562297",
    "socket_event": "ticketcustomfields.deleted"
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams({ name: 'a-1731562297' });
const res = await fetch('/app/TicketCustomFields.Delete', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());

Error Example

{
    "success": 0,
    "message": "Ticket custom field not found."
}