All pages
Powered by GitBook
1 of 1

Loading...

Add parameter to group

post

AddParameterToGroup Associates an existing parameter definition with the specified parameter group and assigns a display order. The parameter definition must already exist and will be added to the group's parameter collection. Returns the created ordered parameter definition with generated ID and audit information. Available for Operations accounts with helpdesk administration permissions.

Path parameters
groupIdstringRequired

The unique identifier of the parameter group

Body

Ordered parameter definition within a parameter group

idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
scopestring · enumOptional

Defines the scope that determines where a parameter is applicable in the helpdesk system.

Possible values:
phasestring · enumOptional

Defines the phase that determines when a parameter is used in the helpdesk workflow.

Possible values:
descriptionstringOptional

The description of the parameter

Example: Customer contact email address
multiplebooleanOptional

Indicates whether the parameter can accept multiple values

Example: false
externalIdstring · nullableOptional

The optional external identifier of the parameter for integration purposes

Example: EXT-PARAM-123
displayOrderinteger · int32 · nullableOptional

The display order of the parameter where a lower value indicates higher priority in the display sequence

Example: 1
hiddenboolean · nullableOptional
readonlyboolean · nullableOptional
requiredboolean · nullableOptional
mininteger · int32Optional
maxinteger · int32Optional
visibilitystring · enumOptional

Defines who can see the parameter in the helpdesk system.

Possible values:
optionsany · nullableOptional

The type-specific options for the parameter which vary based on the parameter type

typestring · enumOptionalPossible values:
casesinteger · int32Optional

The number of cases using this parameter

groupsinteger · int32Optional

The number of groups using this parameter

formsinteger · int32Optional

The number of forms using this parameter

idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
isDeletedbooleanOptional

Indicates whether the parameter definition has been marked as deleted.

idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
labelstringOptional

The translatable label for the parameter group

Example: Customer Information
descriptionstring · nullableOptional

The optional description providing additional context for the parameter group

Example: Basic customer details and contact information
idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
scopestring · enumOptional

Defines the scope that determines where a parameter is applicable in the helpdesk system.

Possible values:
phasestring · enumOptional

Defines the phase that determines when a parameter is used in the helpdesk workflow.

Possible values:
descriptionstringOptional

The description of the parameter

Example: Customer contact email address
multiplebooleanOptional

Indicates whether the parameter can accept multiple values

Example: false
externalIdstring · nullableOptional

The optional external identifier of the parameter for integration purposes

Example: EXT-PARAM-123
displayOrderinteger · int32 · nullableOptional

The display order of the parameter where a lower value indicates higher priority in the display sequence

Example: 1
hiddenboolean · nullableOptional
readonlyboolean · nullableOptional
requiredboolean · nullableOptional
mininteger · int32Optional
maxinteger · int32Optional
visibilitystring · enumOptional

Defines who can see the parameter in the helpdesk system.

Possible values:
optionsany · nullableOptional

The type-specific options for the parameter which vary based on the parameter type

typestring · enumOptionalPossible values:
casesinteger · int32Optional

The number of cases using this parameter

groupsinteger · int32Optional

The number of groups using this parameter

formsinteger · int32Optional

The number of forms using this parameter

idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
isDeletedbooleanOptional

Indicates whether the parameter definition has been marked as deleted.

groupall ofOptional
⤷Circular reference to all of
externalIdstring · nullableOptional

The optional external identifier associated with the parameter group

idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
pyraTenantIdstring · uuid · nullableOptional
externalIdstring · nullableOptional
externalNamestring · nullableOptional
addressLine1string · nullableOptional
addressLine2string · nullableOptional
postCodestring · nullableOptional
citystring · nullableOptional
statestring · nullableOptional
countrystring · nullableOptional
technicalSupportEmailstring · nullableOptional
websitestring · nullableOptional
descriptionstring · nullableOptional
idstringOptional
namestringOptional
revisioninteger · int32Optional
descriptionstring · nullableOptional
logostring · nullableOptional
isDefaultbooleanOptional
clientbooleanOptional
partnerbooleanOptional
defaultLanguageCodestring · nullableOptional
parametersinteger · int32Optional

The number of parameter definitions in this group

formsinteger · int32Optional

The number of non-deleted forms this group is assigned to

isDeletedbooleanOptional

Indicates whether the parameter group has been marked as deleted

Example: false
Responses
201

Created

application/json

Ordered parameter definition within a parameter group

idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
scopestring · enumOptional

Defines the scope that determines where a parameter is applicable in the helpdesk system.

Possible values:
phasestring · enumOptional

Defines the phase that determines when a parameter is used in the helpdesk workflow.

Possible values:
descriptionstringOptional

The description of the parameter

Example: Customer contact email address
multiplebooleanOptional

Indicates whether the parameter can accept multiple values

Example: false
externalIdstring · nullableOptional

The optional external identifier of the parameter for integration purposes

Example: EXT-PARAM-123
displayOrderinteger · int32 · nullableOptional

The display order of the parameter where a lower value indicates higher priority in the display sequence

Example: 1
hiddenboolean · nullableOptional
readonlyboolean · nullableOptional
requiredboolean · nullableOptional
mininteger · int32Optional
maxinteger · int32Optional
visibilitystring · enumOptional

Defines who can see the parameter in the helpdesk system.

Possible values:
optionsany · nullableOptional

The type-specific options for the parameter which vary based on the parameter type

typestring · enumOptionalPossible values:
casesinteger · int32Optional

The number of cases using this parameter

groupsinteger · int32Optional

The number of groups using this parameter

formsinteger · int32Optional

The number of forms using this parameter

idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
isDeletedbooleanOptional

Indicates whether the parameter definition has been marked as deleted.

idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
labelstringOptional

The translatable label for the parameter group

Example: Customer Information
descriptionstring · nullableOptional

The optional description providing additional context for the parameter group

Example: Basic customer details and contact information
idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
scopestring · enumOptional

Defines the scope that determines where a parameter is applicable in the helpdesk system.

Possible values:
phasestring · enumOptional

Defines the phase that determines when a parameter is used in the helpdesk workflow.

Possible values:
descriptionstringOptional

The description of the parameter

Example: Customer contact email address
multiplebooleanOptional

Indicates whether the parameter can accept multiple values

Example: false
externalIdstring · nullableOptional

The optional external identifier of the parameter for integration purposes

Example: EXT-PARAM-123
displayOrderinteger · int32 · nullableOptional

The display order of the parameter where a lower value indicates higher priority in the display sequence

Example: 1
hiddenboolean · nullableOptional
readonlyboolean · nullableOptional
requiredboolean · nullableOptional
mininteger · int32Optional
maxinteger · int32Optional
visibilitystring · enumOptional

Defines who can see the parameter in the helpdesk system.

Possible values:
optionsany · nullableOptional

The type-specific options for the parameter which vary based on the parameter type

typestring · enumOptionalPossible values:
casesinteger · int32Optional

The number of cases using this parameter

groupsinteger · int32Optional

The number of groups using this parameter

formsinteger · int32Optional

The number of forms using this parameter

idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
isDeletedbooleanOptional

Indicates whether the parameter definition has been marked as deleted.

groupall ofOptional
⤷Circular reference to all of
externalIdstring · nullableOptional

The optional external identifier associated with the parameter group

idstringOptional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
atstring · date-time · nullableOptional
idstringOptional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
omittedstring[]Optional
namestringOptional
iconstring · nullableOptional
revisioninteger · int32Optional
typestring · enumOptionalPossible values:
statusstring · enumOptionalPossible values:
pyraTenantIdstring · uuid · nullableOptional
externalIdstring · nullableOptional
externalNamestring · nullableOptional
addressLine1string · nullableOptional
addressLine2string · nullableOptional
postCodestring · nullableOptional
citystring · nullableOptional
statestring · nullableOptional
countrystring · nullableOptional
technicalSupportEmailstring · nullableOptional
websitestring · nullableOptional
descriptionstring · nullableOptional
idstringOptional
namestringOptional
revisioninteger · int32Optional
descriptionstring · nullableOptional
logostring · nullableOptional
isDefaultbooleanOptional
clientbooleanOptional
partnerbooleanOptional
defaultLanguageCodestring · nullableOptional
parametersinteger · int32Optional

The number of parameter definitions in this group

formsinteger · int32Optional

The number of non-deleted forms this group is assigned to

isDeletedbooleanOptional

Indicates whether the parameter group has been marked as deleted

Example: false
403

Forbidden

application/json
typestring · nullableOptional
titlestring · nullableOptional
statusinteger · int32 · nullableOptional
detailstring · nullableOptional
instancestring · nullableOptional
Other propertiesanyOptional
500

Internal Server Error

No content

post/public/v1/helpdesk/parameter-groups/{groupId}/parameters
POST /public/v1/helpdesk/parameter-groups/{groupId}/parameters HTTP/1.1
Host: api.platform.softwareone.com
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "id": "param-def-789",
  "displayOrder": 2
}
{
  "id": "param-def-789",
  "groupId": "group-456",
  "displayOrder": 2,
  "label": "Customer Email",
  "type": "String",
  "revision": 1,
  "audit": {
    "created": {
      "at": "2024-02-02T10:00:00+00:00",
      "by": "admin@example.com"
    }
  }
}

Add parameter to a parameter group