Skip to main content
Put Ticket Category Entity

Headers

Accept-Language
string

Convert string references and multi-language values into a specified language (iso2) code.

SO-Language
string

Convert string references and multi-language values into a specified language (iso2) code. Overrides Accept-Language value.

SO-Culture
string

Number, date formatting in a specified culture (iso2 language) code. Partially overrides SO-Language/Accept-Language value. Ignored if no Language set.

SO-TimeZone
string

Specify the timezone code that you would like date/time responses converted to.

SO-AppToken
string

The application token that identifies the partner app. Used when calling Online WebAPI from a server.

Path Parameters

id
integer<int32>
required

The id of TicketCategoryEntity to be saved.

Body

The details of TicketCategoryEntity to be saved.

This entity describes the meta data for a ticket category, and provides special operations on it. Carrier object for TicketCategoryEntity. Services for the TicketCategoryEntity Carrier is available from the List Agent.

TicketCategoryId
integer<int32>

The id of the ticket category. (primary key)

ParentId
integer<int32>

The parent category for this category. -1 if this is a toplevel category.

Name
string

The (short) name of this category. E.g. 'support'.

Fullname
string

The fullname (compiled from parents' names) for this category. E.g. 'norway/product A/support'.

CategoryMaster
integer<int32>

The user associated with this category.

Flags
enum<string>

A bitmask representing flags for this category.

Available options:
Unknown,
Internal,
OnlyLoggedInUsers,
DefaultToCategoryMaster,
ListInMain,
RedelegateNewMsg,
DelegateToOurContact,
PropagateReplyTemplate,
MembersOnly,
NotifyMembers,
AcceptWhenReplying
DelegateMethod
enum<string>

An integer indicating the delegation method for this category.

Available options:
Unknown,
Even,
Weighted,
Unfair,
Not
ExternalName
string

The external name for this category, used for the customer frontend.

ClosingStatus
enum<string>

Determines the default status used in the GUI when creating a ticket

Available options:
UserDefined,
Active,
Closed,
Postponed
MsgClosingStatus
enum<string>

Determines the default status used in the GUI when adding a request to a ticket

Available options:
UserDefined,
Active,
Closed,
Postponed
AssignmentLag
integer<int32>

Number of minutes we shall override the assignment if a customer sends consecutive messages to this category

ReplyTemplate
integer<int32>

Reply template to merge with messages posted in this category

NotificationEmail
string

Comma separated list of addresses to notify when requests are redelegated to (unassigned) in this category.

DefaultTicketStatus
object

Entity for a ticket status. This entity describes the meta data for a ticket status, and provides special operations on it. Carrier object for TicketStatusEntity. Services for the TicketStatusEntity Carrier is available from the List Agent.

DefaultMessageStatus
object

Entity for a ticket status. This entity describes the meta data for a ticket status, and provides special operations on it. Carrier object for TicketStatusEntity. Services for the TicketStatusEntity Carrier is available from the List Agent.

EffectiveReplyTemplateId
integer<int32>

Id of reply template to merge into messages, whose ticket belongs to this category. Also takes into account 'Apply to subcategories' on parent categories. This is a calculated, readonly field.

ExtraFields
object

Deprecated: Use {SuperOffice.CRM.Services.TicketCategoryEntity.CustomFields} instead. Extra fields added to the carrier. This could be data from Plug-ins, the foreign key system, external applications, etc.

CustomFields
object

Udef + Extra fields added to the carrier. Extra fields as defined by changes to database schema + user-defined fields as defined by admin. Custom fields combines user defined fields and extra fields into one bucket. The individual {SuperOffice.CRM.Services.TicketCategoryEntity.ExtraFields} and UserDefinedFields properties are deprecated in favor of this combined collection.

TableRight
object

Wraps a table right together with an explanatory reason. Code can indicate why access is restricted.

FieldProperties
object

Field property dictionary mapping field names to field access rights.

Response

OK

This entity describes the meta data for a ticket category, and provides special operations on it. Carrier object for TicketCategoryEntity. Services for the TicketCategoryEntity Carrier is available from the List Agent.

TicketCategoryId
integer<int32>

The id of the ticket category. (primary key)

ParentId
integer<int32>

The parent category for this category. -1 if this is a toplevel category.

Name
string

The (short) name of this category. E.g. 'support'.

Fullname
string

The fullname (compiled from parents' names) for this category. E.g. 'norway/product A/support'.

CategoryMaster
integer<int32>

The user associated with this category.

Flags
enum<string>

A bitmask representing flags for this category.

Available options:
Unknown,
Internal,
OnlyLoggedInUsers,
DefaultToCategoryMaster,
ListInMain,
RedelegateNewMsg,
DelegateToOurContact,
PropagateReplyTemplate,
MembersOnly,
NotifyMembers,
AcceptWhenReplying
DelegateMethod
enum<string>

An integer indicating the delegation method for this category.

Available options:
Unknown,
Even,
Weighted,
Unfair,
Not
ExternalName
string

The external name for this category, used for the customer frontend.

ClosingStatus
enum<string>

Determines the default status used in the GUI when creating a ticket

Available options:
UserDefined,
Active,
Closed,
Postponed
MsgClosingStatus
enum<string>

Determines the default status used in the GUI when adding a request to a ticket

Available options:
UserDefined,
Active,
Closed,
Postponed
AssignmentLag
integer<int32>

Number of minutes we shall override the assignment if a customer sends consecutive messages to this category

ReplyTemplate
integer<int32>

Reply template to merge with messages posted in this category

NotificationEmail
string

Comma separated list of addresses to notify when requests are redelegated to (unassigned) in this category.

DefaultTicketStatus
object

Entity for a ticket status. This entity describes the meta data for a ticket status, and provides special operations on it. Carrier object for TicketStatusEntity. Services for the TicketStatusEntity Carrier is available from the List Agent.

DefaultMessageStatus
object

Entity for a ticket status. This entity describes the meta data for a ticket status, and provides special operations on it. Carrier object for TicketStatusEntity. Services for the TicketStatusEntity Carrier is available from the List Agent.

EffectiveReplyTemplateId
integer<int32>

Id of reply template to merge into messages, whose ticket belongs to this category. Also takes into account 'Apply to subcategories' on parent categories. This is a calculated, readonly field.

ExtraFields
object

Deprecated: Use {SuperOffice.CRM.Services.TicketCategoryEntity.CustomFields} instead. Extra fields added to the carrier. This could be data from Plug-ins, the foreign key system, external applications, etc.

CustomFields
object

Udef + Extra fields added to the carrier. Extra fields as defined by changes to database schema + user-defined fields as defined by admin. Custom fields combines user defined fields and extra fields into one bucket. The individual {SuperOffice.CRM.Services.TicketCategoryEntity.ExtraFields} and UserDefinedFields properties are deprecated in favor of this combined collection.

TableRight
object

Wraps a table right together with an explanatory reason. Code can indicate why access is restricted.

FieldProperties
object

Field property dictionary mapping field names to field access rights.