Skip to main content

id-of-asset 

restish dci id-of-asset id

Updates an existing asset, such as G Suite/Workspace or Office 365 subscription, to add or remove licenses.

Request​

Content-Type: application/json

Schema​

{
  "type": "object",
  "properties": {
    "quantity": {
      "type": "integer",
      "format": "int64"
    }
  }
}

Responses​

200 (application/json)​

OK - Asset updated.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "properties": {
      "type": "object",
      "properties": {
        "customerDomain": {
          "type": "string"
        },
        "customerID": {
          "type": "string"
        },
        "reseller": {
          "type": "string"
        },
        "subscription": {
          "type": "object",
          "properties": {
            "billingMethod": {
              "type": "string"
            },
            "creationTime": {
              "type": "integer",
              "format": "int64"
            },
            "id": {
              "type": "string"
            },
            "plan": {
              "type": "object",
              "properties": {
                "commitmentInterval": {
                  "type": "object",
                  "properties": {
                    "endTime": {
                      "type": "integer",
                      "format": "int64"
                    },
                    "startTime": {
                      "type": "integer",
                      "format": "int64"
                    }
                  }
                },
                "isCommitmentPlan": {
                  "type": "boolean"
                },
                "planName": {
                  "type": "string"
                }
              }
            },
            "purchaseOrderID": {
              "type": "string"
            },
            "renewalSettings": {
              "type": "object",
              "properties": {
                "renewalType": {
                  "type": "string"
                }
              }
            },
            "resourceUIURL": {
              "type": "string"
            },
            "seats": {
              "type": "object",
              "properties": {
                "licensedNumberOfSeats": {
                  "type": "integer",
                  "format": "int64"
                },
                "maximumNumberOfSeats": {
                  "type": "integer",
                  "format": "int64"
                },
                "numberOfSeats": {
                  "type": "integer",
                  "format": "int64"
                }
              }
            },
            "skuID": {
              "type": "string"
            },
            "skuName": {
              "type": "string"
            },
            "status": {
              "type": "string"
            }
          }
        }
      }
    },
    "type": {
      "type": "string"
    }
  }
}

400 (application/json)​

Bad Request - The server cannot process the request, often due to a malformed request.

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

401 (application/json)​

Unauthorized - Invalid API key.

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

403 (application/json)​

Forbidden - The client is not authorized to perform the request.

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

404 (application/json)​

Not Found - The requested resource does not exist.

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Detailed error message."
    }
  }
}

Aliases: id-of-asset, idofasset