CCC API v8.4.0.0

<back to all web services

UpdateCollection

The following routes are available for this service:
PUT/api/collections/{CollectionGuid}Update an existing collection.
UpdateCollection Parameters:
NameParameterData TypeRequiredDescription
CollectionGuidpathGuidYes
SiteGuidbodyGuidNo
SiteEndpointGuidbodyGuidNo
NamebodyStringNoThe name of the new collection. Only allowed to be set by SuperUsers.
StatusbodyStringNoStatus of the collection. Only allowed to be set by SuperUsers.

Allowable Values

  • Active
  • Disabled
ServicesApiBaseUrlbodyStringNoThe base URL where this collection can be reached at.
CurrentVersionbodyStringNoCurrent Version of the collection. Only allowed to be set by SuperUsers.
DefaultTrialPeriodbodyIntegerNoDefault Trial Period (in days) of the collection. Only allowed to be set by SuperUsers.
BaseResponse Parameters:
NameParameterData TypeRequiredDescription
ResponseStatusformResponseStatusNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /api/collections/{CollectionGuid} HTTP/1.1 
Host: api.secure-messaging.com 
Accept: application/json
Content-Type: application/json
Content-Length: length

{
  "collectionGuid": "00000000000000000000000000000000",
  "siteGuid": "00000000000000000000000000000000",
  "siteEndpointGuid": "00000000000000000000000000000000",
  "name": "String",
  "status": "String",
  "servicesApiBaseUrl": "String",
  "currentVersion": "String",
  "defaultTrialPeriod": 0
}
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{
  "responseStatus": {
    "errorCode": "String",
    "message": "String",
    "stackTrace": "String",
    "errors": [
      {
        "errorCode": "String",
        "fieldName": "String",
        "message": "String",
        "meta": {
          "String": "String"
        }
      }
    ],
    "meta": {
      "String": "String"
    }
  }
}