# Update parameter definition

## Updates existing parameter definition.

> Updates existing parameter definition.

```json
{"openapi":"3.0.1","info":{"title":"Marketplace API","version":"5.0.5243-ga0bb7c09"},"servers":[{"url":"https://api.platform.softwareone.com"}],"paths":{"/public/v1/helpdesk/parameters/{id}":{"put":{"tags":["Parameter"],"summary":"Updates existing parameter definition.","description":"Updates existing parameter definition.","parameters":[{"name":"id","in":"path","description":"Identifier of the parameter definition to be updated.","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Representation of the parameter definition business object.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpdeskParameterDefinition"}},"text/json":{"schema":{"$ref":"#/components/schemas/HelpdeskParameterDefinition"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/HelpdeskParameterDefinition"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpdeskParameterDefinition"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"500":{"description":"Internal Server Error"}}}}},"components":{"schemas":{"HelpdeskParameterDefinition":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/ParameterDefinitionAudit"}],"description":"Audit information for a parameter definition"},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"scope":{"allOf":[{"$ref":"#/components/schemas/HelpdeskParameterScope"}],"description":"The scope that defines the applicability and context of the helpdesk parameter within the system"},"phase":{"allOf":[{"$ref":"#/components/schemas/HelpdeskParameterPhase"}],"description":"The phase of the parameter in the helpdesk workflow"},"description":{"type":"string","description":"The description of the parameter"},"multiple":{"type":"boolean","description":"Indicates whether the parameter can accept multiple values"},"externalId":{"type":"string","description":"The optional external identifier of the parameter for integration purposes","nullable":true},"displayOrder":{"type":"integer","description":"The display order of the parameter where a lower value indicates higher priority in the display sequence","format":"int32","nullable":true},"constraints":{"allOf":[{"$ref":"#/components/schemas/HelpdeskConstraints"}],"description":"The constraints associated with the parameter including required, readonly, and visibility settings"},"options":{"description":"The type-specific options for the parameter which vary based on the parameter type","nullable":true},"type":{"allOf":[{"$ref":"#/components/schemas/ParameterType"}],"description":"The parameter type defining the data format and validation rules"},"statistics":{"allOf":[{"$ref":"#/components/schemas/ParameterUsageStatistics"}],"description":"Statistics about parameter usage across cases and groups"},"account":{"allOf":[{"$ref":"#/components/schemas/Account"}],"description":"The platform account that owns this parameter definition"},"isDeleted":{"type":"boolean","description":"Indicates whether the parameter definition has been marked as deleted."}},"additionalProperties":false,"description":"Parameter definition in the helpdesk system"},"ParameterDefinitionAudit":{"type":"object","properties":{"created":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"updated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"deleted":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"description":"The deletion event details","nullable":true}},"additionalProperties":false,"description":"Audit information for a parameter definition"},"PlatformObjectEvent":{"type":"object","properties":{"at":{"type":"string","format":"date-time","nullable":true},"by":{"type":"object","allOf":[{"$ref":"#/components/schemas/PlatformIdentityRef"}]}},"additionalProperties":false},"PlatformIdentityRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"}},"additionalProperties":false},"PlatformMetadata":{"type":"object","properties":{"omitted":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"HelpdeskParameterScope":{"enum":["Case","Form"],"type":"string","description":"Defines the scope that determines where a parameter is applicable in the helpdesk system."},"HelpdeskParameterPhase":{"enum":["Request","Response"],"type":"string","description":"Defines the phase that determines when a parameter is used in the helpdesk workflow."},"HelpdeskConstraints":{"type":"object","properties":{"hidden":{"type":"boolean","nullable":true},"readonly":{"type":"boolean","nullable":true},"required":{"type":"boolean","nullable":true},"capacity":{"allOf":[{"$ref":"#/components/schemas/CapacitySettings"}],"nullable":true},"visibility":{"allOf":[{"$ref":"#/components/schemas/VisibilityMode"}],"description":"The visibility mode controlling who can see the parameter","nullable":true}},"additionalProperties":false,"description":"Constraints specific to helpdesk parameters"},"CapacitySettings":{"type":"object","properties":{"min":{"type":"integer","format":"int32"},"max":{"type":"integer","format":"int32"}},"additionalProperties":false},"VisibilityMode":{"enum":["All","OnlyMyAccount"],"type":"string","description":"Defines who can see the parameter in the helpdesk system."},"ParameterType":{"enum":["SingleLineText","MultiLineText","Address","Contact","Checkbox","Choice","Subdomain","Heading","DropDown","Email","DataObject","Date"],"type":"string"},"ParameterUsageStatistics":{"type":"object","properties":{"cases":{"type":"integer","description":"The number of cases using this parameter","format":"int32","nullable":true},"groups":{"type":"integer","description":"The number of groups using this parameter","format":"int32","nullable":true},"forms":{"type":"integer","description":"The number of forms using this parameter","format":"int32","nullable":true}},"additionalProperties":false,"description":"Usage statistics for a parameter definition"},"Account":{"type":"object","properties":{"id":{"type":"string"},"audit":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectAudit"}]},"$meta":{"allOf":[{"$ref":"#/components/schemas/PlatformMetadata"}],"nullable":true},"name":{"type":"string"},"icon":{"type":"string","nullable":true},"revision":{"type":"integer","format":"int32"},"type":{"allOf":[{"$ref":"#/components/schemas/AccountType"}],"nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/AccountStatus"}],"nullable":true},"externalIds":{"allOf":[{"$ref":"#/components/schemas/AccountExternalIds"}],"nullable":true},"externalId":{"type":"string","nullable":true},"externalName":{"type":"string","nullable":true},"address":{"allOf":[{"$ref":"#/components/schemas/Address"}]},"technicalSupportEmail":{"type":"string","nullable":true},"website":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"groups":{"type":"array","items":{"$ref":"#/components/schemas/UserGroupRef"},"nullable":true},"eligibility":{"allOf":[{"$ref":"#/components/schemas/Eligibility"}],"nullable":true},"defaultLanguageCode":{"type":"string","nullable":true}},"additionalProperties":false},"PlatformObjectAudit":{"type":"object","properties":{"created":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true},"updated":{"allOf":[{"$ref":"#/components/schemas/PlatformObjectEvent"}],"nullable":true}},"additionalProperties":false},"AccountType":{"enum":["Client","Vendor","Operations"],"type":"string"},"AccountStatus":{"enum":["Active","Enabled","Disabled"],"type":"string"},"AccountExternalIds":{"type":"object","properties":{"pyraTenantId":{"type":"string","format":"uuid","nullable":true}},"additionalProperties":false},"Address":{"type":"object","properties":{"addressLine1":{"type":"string","nullable":true},"addressLine2":{"type":"string","nullable":true},"postCode":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"country":{"type":"string","nullable":true}},"additionalProperties":false},"UserGroupRef":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"revision":{"type":"integer","format":"int32"},"description":{"type":"string","nullable":true},"logo":{"type":"string","nullable":true},"isDefault":{"type":"boolean"}},"additionalProperties":false},"Eligibility":{"type":"object","properties":{"client":{"type":"boolean"},"partner":{"type":"boolean"}},"additionalProperties":false},"ProblemDetails":{"type":"object","properties":{"type":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"status":{"type":"integer","format":"int32","nullable":true},"detail":{"type":"string","nullable":true},"instance":{"type":"string","nullable":true}},"additionalProperties":{}}}}}
```