Jump to

• Request
• Response
• Examples

Renew Asset

post

/rest/v19/assets/{id}/actions/renew

This operation merges a renew request with the projected asset for the requested date, and then stores the results to a Configuration BOM Instance. For renew requests, the root and subordinate action codes are set to Renew.

Request

Supported Media Types

• application/json

Path Parameters

• id(required): integer
  Primary Key of Asset Resource.

Body ()

Root Schema : assets-renewRequest

Type: object

Show Source

• sourceIdentifier: string
  Title: Source Identifier

  The variable name of the commerce process or external application identifier.
• transactionDate: string
  Title: Transaction Date

  The date and time on which the service request was made.
• transactionId: string
  Title: Transaction Id

  The current transaction identifier.

{
    "type":"object",
    "properties":{
        "sourceIdentifier":{
            "type":"string",
            "description":"The variable name of the commerce process or external application identifier.",
            "title":"Source Identifier "
        },
        "transactionDate":{
            "type":"string",
            "description":"The date and time on which the service request was made.",
            "title":"Transaction Date"
        },
        "transactionId":{
            "type":"string",
            "description":"The current transaction identifier.",
            "title":"Transaction Id"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

Default Response

Body ()

Root Schema : assets-renewResponse

Type: object

Show Source

• result: object ABO Headless Service Response.
  Title: ABO Headless Service Response.

  Response Schema for ABO related actions which are used to create transaction line without launching configurator UI such as terminate, suspend, resume.
• resultTransactionId: integer
  Title: Result Transaction Id

  New transaction id created as part of asset operation.

{
    "type":"object",
    "properties":{
        "result":{
            "$ref":"#/definitions/aboHeadlessServiceResponse"
        },
        "resultTransactionId":{
            "type":"integer",
            "description":"New transaction id created as part of asset operation.",
            "title":"Result Transaction Id"
        }
    }
}

Nested Schema : ABO Headless Service Response.

Type: object

Title: ABO Headless Service Response.

Response Schema for ABO related actions which are used to create transaction line without launching configurator UI such as terminate, suspend, resume.

Show Source

• bomkey: string
  Bom instance id also is asset-key for the newly created order line.
• lineId: string
  Transaction line identifier for the created line, for CPQ internal commerce process, it is line number, for external commerce application, it is config_id which can be used to construct the endpoint to access specific config instance.

{
    "type":"object",
    "properties":{
        "lineId":{
            "type":"string",
            "description":"Transaction line identifier for the created line, for CPQ internal commerce process, it is line number, for external commerce application, it is config_id which can be used to construct the endpoint to access specific config instance."
        },
        "bomkey":{
            "type":"string",
            "description":"Bom instance id also is asset-key for the newly created order line."
        }
    },
    "title":"ABO Headless Service Response.",
    "description":"Response Schema for ABO related actions which are used to create transaction line without launching configurator UI such as terminate, suspend, resume."
}

Back to Top

Examples

The following example shows how to renew an asset by submitting a POST request to the REST resource using cURL. For more information about cURL, see Use cURL.

curl -X POST  -H "Authorization: Bearer <token>" -H "Content-type: application/json" -H "Accept: application/json"
https://sitename.oracle.com/rest/v19/assets/36562516/actions/renew

Request Body Sample

{
  "sourceIdentifier": "oraclecpqo",
  "transactionDate": "2025-04-14",
  "transactionId": ""
}

Response Body Sample

{
  "result": {
    "bomkey": "BOM_SupremoIndividualItems",
    "linenum": "2"
  },
  "resultTransactionId": "36562570"
}

Back to Top