Update an instance of assets

patch

/services/rest/connect/latest/assets/{id}

Request

Path Parameters
Body ()
Representation of a business asset.
Root Schema : assets
Type: object
Representation of a business asset.
Show Source
Nested Schema : contacts
Type: object
Customers or end users of a site
Show Source
Nested Schema : organizations
Type: object
Business organization
Show Source
Nested Schema : assets-price
Type: object
Monetary value that consists of currency, exchange rate, and value.
Show Source
Nested Schema : salesProducts
Type: object
Product available to customers and organizations through quotes or offer advisor
Show Source
Nested Schema : assets-sLAInstances
Type: object
Instance of a Service Level Agreement (SLA). An instance is created when a Service Level Agreement (SLA) is associated with a contact or organization.
Show Source
Nested Schema : assets-statusWithType
Type: object
Current status and associated status type of an Asset.
Show Source
Nested Schema : contacts-address
Type: object
Groups all address information
Show Source
Nested Schema : contacts-banner
Type: object
Banner display flags
Show Source
Nested Schema : contacts-channelUsernames
Type: object
Channel username.
Show Source
Nested Schema : namedIDs-contacts-contactType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : contacts-cRMModules
Type: object
Group of flags indicating the modules that are applicable for an object
Show Source
Nested Schema : contacts-emails
Type: object
Email address and associated information
Show Source
  • Maximum Length: 80
    Pattern: ^((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[; ]*)$
    Email address string
  • namedIDs-contacts-emails-addressType
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • Maximum Length: 1333
    Pattern: ^( | )*[-]+BEGIN CERTIFICATE[-]+[0-9a-zA-Z+/= ]*[-]+END CERTIFICATE[-]+( | )*$
    Associated public email certificate, used to encrypt outgoing email.
  • Disables the email address
Nested Schema : contacts-fileAttachments
Type: object
File attachment that includes additional fields used for attachments to several different classes
Show Source
  • Maximum Length: 128
    Pattern: ^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$
    MIME content type for file contents (e.g. text/plain, audio/mp3, image/jpg)
  • Date and time when file was associated with object. Read-only
  • Data contained within the file. Only Base64 encoded data allowed. MaxBytes constraint specifies decoded data length supported.
  • Maximum Length: 1333
    Text describing file contents
  • Maximum Length: 100
    Pattern: ^[^ \/:*?"<>|]*$
    Name to be used for file when it is saved to disk
  • HTML form that can be used for file attachments upload
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • Maximum Length: 40
    Pattern: ^[^ ]*$
    Short display name
  • Minimum Value: 1
    Maximum Value: 2147483647
    Length of file data in bytes. Read-only
  • Last updated date and time. Read-only
  • Maximum Length: 1333
    A URL to this file
Nested Schema : contacts-marketingSettings
Type: object
Marketing related information for the contact
Show Source
Nested Schema : contacts-name
Type: object
A person's first and last name
Show Source
Nested Schema : contacts-nameFurigana
Type: object
A person's first and last name
Show Source
Nested Schema : contacts-notes
Type: object
Note text associated with objects in the system like contacts and organizations
Show Source
Nested Schema : contacts-openIDAccounts
Type: object
OpenID related information for the contact
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • Maximum Length: 255
    The authentication URL for this OpenIDAccount item. Must be unique.
Nested Schema : contacts-phones
Type: object
A phone number and its ancillary data
Show Source
  • Maximum Length: 40
    Pattern: ^[][+0-9a-zA-Z[:blank:].,()#-/]*$
    Free-form phone number
  • namedIDs-contacts-phones-phoneType
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • Maximum Length: 40
    Automatically populated with the numerical data from the Number; i.e. if Number contained "1 (406) 522-4200", this field would contain "14065224200". Read-only
Nested Schema : contacts-salesSettings
Type: object
Sales related information for the contact
Show Source
Nested Schema : contacts-serviceSettings
Type: object
Service related information for the contact
Show Source
Nested Schema : namedIDHierarchies-contacts-source
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : countries
Type: object
Represents a country object defined in the system.
Show Source
  • Maximum Length: 3
    Pattern: ^[A-Z]{2,3}$
    The two or three character abbreviation for this country.
  • Creation date and time. Read-only
  • Minimum Value: 1
    Maximum Value: 2147483647
    The position of the country in the Countries/Provinces tree and drop-down menu.
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier
  • Maximum Length: 2
    Pattern: ^[A-Z]{2}$
    The ISO 3166 country code.
  • Maximum Length: 255
    Name used to lookup this object
  • Maximum Length: 80
    Name of the Country in the current interface's language. Read-only.
  • countries-names
    Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
  • Maximum Length: 10
    Pattern: ^[][+0-9a-zA-Z[:blank:].,()#-/]*$
    used by the Click-to-Dial feature."
  • Maximum Length: 80
    Pattern: ^(([U|L|M][#|A|L|C])|(F.))+$
    A string of twice as many characters as found in the phone number. Two (2) characters are needed to represent every digit or character in the phone number. The first character of the mask describes the target character and the second constrains its type.
  • Maximum Length: 20
    Pattern: ^(([U|L|M][#|A|L|C])|(F.))+$
    A string of twice as many characters as found in the postal code (target). Two (2) characters are needed to represent every digit or character in the postal code. The first character of the mask describes the target character and the second constrains its type.
  • countries-provinces
    Contains information about the provinces in the Countries/Provinces customizable menu.
  • Last updated date and time. Read-only
Nested Schema : namedIDs-contacts-address-stateOrProvince
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : countries-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : countries-provinces
Type: object
Contains information about the provinces in the Countries/Provinces customizable menu.
Show Source
  • Minimum Value: 1
    Maximum Value: 32767
    Display position relative to other provinces associated with the same country.
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    The Province ID.
  • Maximum Length: 255
    The name of the province in the current interface's language. Read-only.
  • countries-provinces-names
    Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Nested Schema : namedIDs-countries-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : countries-provinces-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-countries-provinces-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-banner-importanceFlag
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : accounts
Type: object
An account generated for a staff member in the system. Staff accounts are used by CSRs, sales agents, site administrators, etc.
Show Source
Nested Schema : accounts-attributes
Type: object
Group of flags which enable certain features or special behaviors on an Account
Show Source
  • Temporarily locks the staff account. You might choose to do this if, for example, a staff member takes a leave of absence. This will also be set automatically if a staff member has exceeded the number of invalid logins or has an expired password.
  • Enables the staff account to modify the email signature.
  • Forces the staff member to change her password the next time she logs in. Note: This flag remains true until the staff member changes her password.
  • Flag that indicates if the staff account is considered an infrequent user seat, as opposed to a full seat.
  • Disables password expiration. This will override any system-wide password expiration configurations.
  • Permanently disables the staff account (for example, when a staff member leaves your organization). Note: The staff account will continue to appear in the tree of the Staff Accounts management console if the Show Disabled setting is on, but you will not be able to clear the Permanently Disable check box if you edit the account. You can reuse the login name of a permanently disabled staff account for a different staff account.
  • Prevents the staff account from being assigned to incidents, answers, opportunities, and tasks
  • Prevents the staff account from being included in the list for filters in reports
  • Flag indicating if the account is a Virtual Account. Read-only
Nested Schema : namedIDs-accounts-emailNotification
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : accounts-emails
Type: object
Email address and associated information
Show Source
  • Maximum Length: 80
    Pattern: ^((([-_!#$%&'*+/=?^~`{|}\w]+(\.[.]?[-_!#$%&'*+/=?^~`{|}\w]+)*)|("[^"]+"))@[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*(\.[0-9A-Za-z]+([\-]+[0-9A-Za-z]+)*)+[; ]*)$
    Email address string
  • namedIDs-accounts-emails-addressType
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • Maximum Length: 1333
    Pattern: ^( | )*[-]+BEGIN CERTIFICATE[-]+[0-9a-zA-Z+/= ]*[-]+END CERTIFICATE[-]+( | )*$
    Associated public email certificate, used to encrypt outgoing email.
  • Disables the email address
Nested Schema : accounts-name
Type: object
A person's first and last name where both are required
Show Source
  • Maximum Length: 80
    Pattern: ^[^ ]*$
    Given or first name
  • Maximum Length: 80
    Pattern: ^[^ ]*$
    Surname or last name
Nested Schema : accounts-nameFurigana
Type: object
A person's first and last name
Show Source
Nested Schema : accounts-phones
Type: object
A phone number and its ancillary data
Show Source
  • Maximum Length: 40
    Pattern: ^[][+0-9a-zA-Z[:blank:].,()#-/]*$
    Free-form phone number
  • namedIDs-accounts-phones-phoneType
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • Maximum Length: 40
    Automatically populated with the numerical data from the Number; i.e. if Number contained "1 (406) 522-4200", this field would contain "14065224200". Read-only
Nested Schema : namedIDs-accounts-profile
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : accounts-salesSettings
Type: object
Sales related information for the account
Show Source
Nested Schema : accounts-serviceSettings
Type: object
Service related information for the account
Show Source
  • Minimum Value: 1
    Maximum Value: 65535
    Port number on which to listen for screen pop alerts destined for the staff account. Used in Citrix and Terminal Services environments where there are multiple agents logged in to different sessions on the same machine.
Nested Schema : namedIDs-accounts-staffGroup
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-accounts-emails-addressType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-accounts-phones-phoneType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-accounts-salesSettings-defaultCurrency
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : salesTerritories
Type: object
A specific geographical sales region
Show Source
Nested Schema : namedIDs-salesTerritories-adminVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : salesTerritories-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-salesTerritories-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : channelTypes
Type: object
Channel Type
Show Source
Nested Schema : channelTypes-attributes
Type: object
Channel Type Options
Show Source
Nested Schema : channelTypes-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-channelTypes-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-emails-addressType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-marketingSettings-contactLists
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : namedIDs-contacts-marketingSettings-emailFormat
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-notes-channel
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-phones-phoneType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : contacts-serviceSettings-answerNotifications
Type: object
Notification that should be sent to a contact when an answer has been updated
Show Source
  • answers
    Customer questions and answers maintained in the Knowledge Base
  • siteInterfaces
    The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name.
  • Date and time when notification period began. Read-only
Nested Schema : contacts-serviceSettings-categoryNotifications
Type: object
Notification that should be sent to a contact when a category has been updated
Show Source
Nested Schema : contacts-serviceSettings-productNotifications
Type: object
Notification that should be sent to a contact when a product has been updated
Show Source
  • siteInterfaces
    The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name.
  • serviceProducts
    Hierarchical service product
  • Date and time when notification period began
Nested Schema : contacts-serviceSettings-sLAInstances
Type: object
Instance of a Service Level Agreement (SLA). An instance is created when a Service Level Agreement (SLA) is associated with a contact or organization.
Show Source
Nested Schema : answers
Type: object
Customer questions and answers maintained in the Knowledge Base
Show Source
Nested Schema : siteInterfaces
Type: object
The console, windows, and pages used by staff members and customers to access the application and interact with a single knowledge base. The interface name determines the URL for the web site, the name of the system executables, and the .cfg directory name.
Show Source
Nested Schema : namedIDs-answers-accessLevels
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    The numeric ID/value for the AccessLevel
  • Maximum Length: 255
    The name for this AccessLevel
Nested Schema : namedIDs-answerTypes
Type: object
The AnswerType of an Answer
Show Source
Nested Schema : answerVersions
Type: object
A versioned instance of an answer. Customer questions and answers maintained in the Knowledge Base
Show Source
Nested Schema : answers-assignedTo
Type: object
Bundle of staff account and staff group.
Show Source
Nested Schema : answers-banner
Type: object
Banner display flags
Show Source
Nested Schema : serviceCategories
Type: object
Hierarchical service category
Show Source
Nested Schema : answers-commonAttachments
Type: object
File attachment that includes fields specific to attachments shared by sibling answers
Show Source
  • Maximum Length: 128
    Pattern: ^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$
    MIME content type for file contents (e.g. text/plain, audio/mp3, image/jpg)
  • Date and time when file was associated with object. Read-only
  • Data contained within the file. Only Base64 encoded data allowed. MaxBytes constraint specifies decoded data length supported.
  • Disables display of file attachment when associated answer is viewed. If the Private flag is not set, this flag hides the attachment.
  • Maximum Length: 100
    Pattern: ^[^ \/:*?"<>|]*$
    Name to be used for file when it is saved to disk
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • answers-commonAttachments-names
    Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
  • Disallows display of the file attachment to end-users
  • Minimum Value: 1
    Maximum Value: 2147483647
    Length of file data in bytes. Read-only
  • Last updated date and time. Read-only
  • Maximum Length: 1333
    A URL to this file
Nested Schema : answers-fileAttachments
Type: object
File attachment that includes fields specific to answers
Show Source
  • Maximum Length: 128
    Pattern: ^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$
    MIME content type for file contents (e.g. text/plain, audio/mp3, image/jpg)
  • Date and time when file was associated with object. Read-only
  • Data contained within the file. Only Base64 encoded data allowed. MaxBytes constraint specifies decoded data length supported.
  • Maximum Length: 1333
    Text describing file contents
  • Disables display of file attachment when associated answer is viewed. If the Private flag is not set, this flag hides the attachment.
  • Maximum Length: 100
    Pattern: ^[^ \/:*?"<>|]*$
    Name to be used for file when it is saved to disk
  • HTML form that can be used for file attachments upload
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • Causes the file attachment's contents to be included in keyword indexing of the answer
  • Maximum Length: 40
    Pattern: ^[^ ]*$
    Short display name
  • Disallows display of the file attachment to end-users
  • Minimum Value: 1
    Maximum Value: 2147483647
    Length of file data in bytes. Read-only
  • Last updated date and time. Read-only
  • Maximum Length: 1333
    A URL to this file
Nested Schema : namedIDs-answers-guidedAssistance
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : answers-notes
Type: object
Note text associated with objects in the system like contacts and organizations
Show Source
Nested Schema : namedIDs-answers-positionInList
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : serviceProducts
Type: object
Hierarchical service product
Show Source
Nested Schema : answers-relatedAnswers
Type: object
Links an answer to related answers
Show Source
Nested Schema : answers-statusWithType
Type: object
Status of an object with its associated status type
Show Source
Nested Schema : answers-versionDetail
Type: object
Version Draft Note
Show Source
Nested Schema : namedIDs-answerVersions-accessLevels
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    The numeric ID/value for the AccessLevel
  • Maximum Length: 255
    The name for this AccessLevel
Nested Schema : namedIDs-answerVersions-answerType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : answerVersions-assignedTo
Type: object
Bundle of staff account and staff group.
Show Source
Nested Schema : answerVersions-banner
Type: object
Banner display flags
Show Source
Nested Schema : answerVersions-commonAttachments
Type: object
File attachment that includes fields specific to attachments shared by sibling answers
Show Source
  • Maximum Length: 128
    Pattern: ^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$
    MIME content type for file contents (e.g. text/plain, audio/mp3, image/jpg)
  • Date and time when file was associated with object. Read-only
  • Data contained within the file. Only Base64 encoded data allowed. MaxBytes constraint specifies decoded data length supported.
  • Disables display of file attachment when associated answer is viewed. If the Private flag is not set, this flag hides the attachment.
  • Maximum Length: 100
    Pattern: ^[^ \/:*?"<>|]*$
    Name to be used for file when it is saved to disk
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • answerVersions-commonAttachments-names
    Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
  • Disallows display of the file attachment to end-users
  • Minimum Value: 1
    Maximum Value: 2147483647
    Length of file data in bytes. Read-only
  • Last updated date and time. Read-only
  • Maximum Length: 1333
    A URL to this file
Nested Schema : answerVersions-fileAttachments
Type: object
File attachment that includes fields specific to answers
Show Source
  • Maximum Length: 128
    Pattern: ^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$
    MIME content type for file contents (e.g. text/plain, audio/mp3, image/jpg)
  • Date and time when file was associated with object. Read-only
  • Data contained within the file. Only Base64 encoded data allowed. MaxBytes constraint specifies decoded data length supported.
  • Maximum Length: 1333
    Text describing file contents
  • Disables display of file attachment when associated answer is viewed. If the Private flag is not set, this flag hides the attachment.
  • Maximum Length: 100
    Pattern: ^[^ \/:*?"<>|]*$
    Name to be used for file when it is saved to disk
  • HTML form that can be used for file attachments upload
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • Causes the file attachment's contents to be included in keyword indexing of the answer
  • Maximum Length: 40
    Pattern: ^[^ ]*$
    Short display name
  • Disallows display of the file attachment to end-users
  • Minimum Value: 1
    Maximum Value: 2147483647
    Length of file data in bytes. Read-only
  • Last updated date and time. Read-only
  • Maximum Length: 1333
    A URL to this file
Nested Schema : namedIDs-answerVersions-guidedAssistance
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answerVersions-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : answerVersions-notes
Type: object
Note text associated with objects in the system like contacts and organizations
Show Source
Nested Schema : namedIDs-answerVersions-positionInList
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : answerVersions-relatedAnswers
Type: object
Links an answer to related answers
Show Source
Nested Schema : answerVersions-statusWithType
Type: object
Status of an object with its associated status type
Show Source
Nested Schema : answerVersions-versionDetail
Type: object
Version Draft Note
Show Source
Nested Schema : namedIDs-answerVersions-assignedTo-staffGroup
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answerVersions-banner-importanceFlag
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : answerVersions-commonAttachments-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-answerVersions-commonAttachments-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answerVersions-notes-channel
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answerVersions-statusWithType-status
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answerVersions-statusWithType-statusType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answerVersions-versionDetail-state
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-assignedTo-staffGroup
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-banner-importanceFlag
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-serviceCategories-adminVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : serviceCategories-descriptions
Type: object
String that is language-specific, allowing localization. Labels will be assembled in a list that is associated with one particular text field.
Show Source
Nested Schema : namedIDs-serviceCategories-endUserVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : serviceCategories-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-serviceCategories-descriptions-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-serviceCategories-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : answers-commonAttachments-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-answers-commonAttachments-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-notes-channel
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-serviceProducts-adminVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : serviceProducts-descriptions
Type: object
String that is language-specific, allowing localization. Labels will be assembled in a list that is associated with one particular text field.
Show Source
Nested Schema : namedIDs-serviceProducts-endUserVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : serviceProducts-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-serviceProducts-descriptions-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : serviceDispositions
Type: object
Hierarchical service disposition
Show Source
Nested Schema : namedIDs-serviceDispositions-adminVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : serviceDispositions-descriptions
Type: object
String that is language-specific, allowing localization. Labels will be assembled in a list that is associated with one particular text field.
Show Source
Nested Schema : serviceDispositions-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : namedIDs-serviceDispositions-descriptions-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-serviceDispositions-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-serviceProducts-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-statusWithType-status
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-statusWithType-statusType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-answers-versionDetail-state
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-siteInterfaces-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-serviceSettings-sLAInstances-nameOfSLA
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-contacts-serviceSettings-sLAInstances-stateOfSLA
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDHierarchies-contacts-source-parents
Type: object
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Show Source
Nested Schema : organizations-addresses
Type: object
Physical address
Show Source
Nested Schema : organizations-banner
Type: object
Banner display flags
Show Source
Nested Schema : organizations-cRMModules
Type: object
Group of flags indicating the modules that are applicable for an object
Show Source
Nested Schema : organizations-fileAttachments
Type: object
File attachment that includes additional fields used for attachments to several different classes
Show Source
  • Maximum Length: 128
    Pattern: ^[a-zA-Z-]+/[-a-zA-Z0-9.+_*]+$
    MIME content type for file contents (e.g. text/plain, audio/mp3, image/jpg)
  • Date and time when file was associated with object. Read-only
  • Data contained within the file. Only Base64 encoded data allowed. MaxBytes constraint specifies decoded data length supported.
  • Maximum Length: 1333
    Text describing file contents
  • Maximum Length: 100
    Pattern: ^[^ \/:*?"<>|]*$
    Name to be used for file when it is saved to disk
  • HTML form that can be used for file attachments upload
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    Primary key identifier. This is the key for the list entry.
  • Maximum Length: 40
    Pattern: ^[^ ]*$
    Short display name
  • Minimum Value: 1
    Maximum Value: 2147483647
    Length of file data in bytes. Read-only
  • Last updated date and time. Read-only
  • Maximum Length: 1333
    A URL to this file
Nested Schema : namedIDs-organizations-industry
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : organizations-notes
Type: object
Note text associated with objects in the system like contacts and organizations
Show Source
Nested Schema : organizations-salesSettings
Type: object
Sales related information for the organization
Show Source
Nested Schema : organizations-serviceSettings
Type: object
Service related information for the organization
Show Source
Nested Schema : namedIDHierarchies-organizations-source
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-organizations-addresses-addressType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-organizations-addresses-stateOrProvince
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-organizations-banner-importanceFlag
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-organizations-notes-channel
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : organizations-salesSettings-totalRevenue
Type: object
Monetary value that consists of currency, exchange rate, and value.
Show Source
Nested Schema : namedIDs-organizations-salesSettings-totalRevenue-currency
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-organizations-salesSettings-totalRevenue-exchangeRate
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : organizations-serviceSettings-sLAInstances
Type: object
Instance of a Service Level Agreement (SLA). An instance is created when a Service Level Agreement (SLA) is associated with a contact or organization.
Show Source
Nested Schema : namedIDs-organizations-serviceSettings-sLAInstances-nameOfSLA
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-organizations-serviceSettings-sLAInstances-stateOfSLA
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDHierarchies-organizations-source-parents
Type: object
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Show Source
Nested Schema : namedIDs-assets-price-currency
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-assets-price-exchangeRate
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-salesProducts-adminVisibleInterfaces
Type: object
Named ID that can be included in a list
Show Source
  • Minimum Value: 1
    Maximum Value: 9.223372036854776E18
    ID value. This is the key for the list entry.
  • Maximum Length: 255
    Name used to lookup this object
Nested Schema : salesProducts-attributes
Type: object
Attribute options for the product object.
Show Source
Nested Schema : salesProducts-descriptions
Type: object
String that is language-specific, allowing localization. Labels will be assembled in a list that is associated with one particular text field.
Show Source
Nested Schema : salesProducts-folder
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : salesProducts-names
Type: object
Strings that are language-specific, allowing localization of fields. Like the Label class, but the label text cannot be empty or null. Labels will be assembled in a list that is associated with one particular text field
Show Source
Nested Schema : salesProducts-schedules
Type: object
A price schedule for a sales product
Show Source
Nested Schema : namedIDs-salesProducts-descriptions-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : salesProducts-folder-parents
Type: object
NamedID in which the ID is read-only. Used for hierarchies, where caller can specify the parents by name, but cannot specify the parent IDs.
Show Source
Nested Schema : namedIDs-salesProducts-names-language
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : salesProducts-schedules-price
Type: object
Monetary value that consists of currency, exchange rate, and value.
Show Source
Nested Schema : namedIDs-salesProducts-schedules-schedule
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-salesProducts-schedules-price-currency
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-salesProducts-schedules-price-exchangeRate
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-assets-sLAInstances-nameOfSLA
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-assets-sLAInstances-stateOfSLA
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-assets-statusWithType-status
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-assets-statusWithType-statusType
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source

Response

Default Response

Examples

Use the PATCH operation with the following syntax to partially update an asset object:

https://your_site_interface/services/rest/connect/version/assets/asset_id

Include the data to be updated in the request body. Only the fields present in the request JSON data are updated. All other fields remain the same.

Request URI example

https://mysite.example.com/services/rest/connect/v1.4/assets/3

Request body example

{
"price":
    {
    "currency":
        {
        "id": 1
        },
    "value": 750
    }
}

Response example

The status 200 OK is returned. Then getting the data for asset 3 returns the following:

{
  "id": 3,
  "lookupName": "Blizzard",
  "contact": null,
  "customFields": {},
  "description": null,
  "installedDate": null,
  "name": "Blizzard",
  "organization": null,
  "price": {
    "currency": {
      "id": 1,
      "lookupName": "USD"
    },
    "exchangeRate": null,
    "value": 750
  },

...

}

Note:

The price for asset 3 used to be 0.