Initiate Renewal Action

Initiate the renewal of an asset.

This action is available in API version 60.0 and later.

Supported REST HTTP Methods

URI
/services/data/v63.0/actions/standard/initiateRenewal
Formats
JSON, XML
HTTP Methods
POST
Authentication
Authorization: Bearer token

Inputs

Input Details
renewAssetIds
Type
string
Description

Required.

The IDs of the assets that you want to renew.

renewContractId
Type
string
Description

The ID of the contract record to be synced with the renewal.

renewEndDate
Type
datetime
Description

Effective end date of the renewal. Available in API version 62.0 and later.

renewOpportunityId
Type
string
Description

The ID of the Opportunity record to be synced with the renewal quote.

renewOutputType
Type
string
Description

Required.

Type of renewal record to create.

renewStartDate
Type
datetime
Description

Effective start date of the renewal. Available in API version 62.0 and later.

Outputs

Output Details
renewRecordId
Type
string
Description
The ID of the amendment record that’s created.
requestIdentifier
Type
string
Description
Request ID that’s used to track the async request.

Example

POST

This sample request is for the Initiate Renewal action.

{
    "inputs": [
        {
            "renewAssetIds": ["02ixx0000004LMwAAM"],
            "renewOutputType": "Quote",
            "renewContractId" : "contract ID",
            "renewOpportunityId" : "Opportunity ID",
            "renewStartDate": "2023-10-21T00:00:00.000Z",
            "renewEndDate": "2024-10-21T00:00:00.000Z"
        }
    ]
}

This sample response is for the Initiate Renewal action.

[
    {
        "actionName": "initiateRenewal",
        "errors": null,
        "isSuccess": true,
        "outputValues": {
            "record_id": "0Q0xx0000004P32CAE",
            "requestIdentifier": "16Pxx0000004OTY"
        },
        "version": 1
    }
]