Update an action
patch
/crmRestApi/resources/11.13.18.05/actions/{ActionNumber}
Request
Path Parameters
-
ActionNumber(required): string
The alternate unique identifier of the action.
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object-
actionAttribute: array
Action Attributes
Title:
Action AttributesThe action attributes resource is used to view, create, update, and delete the attributes that are set while creating or updating the related object of an action. -
ActionCategoryCd: string
Title:
CategoryMaximum Length:30The code indicating the category of the action. A list of valid values is defined in the lookup ORA_SVC_AP_ACTION_CATEGORY_CD. -
ActionCategoryCdMeaning: string
Title:
Action Category ValueMaximum Length:255The display value corresponding to the action category lookup code for the action. -
actionCondition: array
Action Conditions
Title:
Action ConditionsThe action conditions resource is used to view, create, update, and delete the definitions of the status mapping conditions for the related object of an action. -
BUOrgId: integer
(int64)
Title:
Business Unit IDThe unique identifier of the business unit name associated to the action. -
BusinessUnitName: string
Title:
Business Unit IDThe name of the business unit associated to the action. -
CopyAttachmentsFlag: boolean
Title:
Copy AttachmentsMaximum Length:1Default Value:falseIndicates whether the attachments are copied from the parent context to the child object. -
DeletedFlag: boolean
Title:
DeletedMaximum Length:1Default Value:falseIndicates whether the action is deleted. The default value is false. -
Description: string
Title:
DescriptionMaximum Length:1000The description of the action. -
LeadTime: integer
(int64)
Title:
DurationThe estimated time required to complete the action. -
LeadTimeUnit: string
Title:
Duration UnitMaximum Length:30The unit of measurement of the lead time, such as minutes, hours, or days. -
LeadTimeUnitMeaning: string
Title:
Lead Time Unit ValueMaximum Length:255The display value corresponding to the lead time unit lookup code for the action. -
Name: string
Title:
ActionMaximum Length:400The name of the action. -
ObjectEntityNameMeaning: string
Title:
Object Entity Name ValueMaximum Length:255The display value corresponding to the object entity name lookup code for the action. -
ObjectEntityTypeMeaning: string
Title:
Object Entity Type ValueMaximum Length:255The display value corresponding to the object entity type lookup code for the action. -
ObjectLinkTypeId: integer
(int64)
Title:
Object Link Type IdThe object link type identifier associated to the action. -
ObjectLinkTypeNumber: string
Title:
Link Type NumberMaximum Length:255The public unique identifier of the object link type associated with the action. -
OperationCd: string
Title:
Operation CodeMaximum Length:30The operation code entry for the action. A list of valid values is defined in the lookup ORA_SVC_AP_OPERATION_CD. -
OperationCdMeaning: string
Title:
Operation ValueMaximum Length:255The display value corresponding to the operation lookup code for the action. -
OriginalSystemReference: string
Title:
Original System ReferenceMaximum Length:255The reference to the original system from which the action was imported (if imported). -
ParentEntityNameMeaning: string
Title:
Parent Entity Name ValueMaximum Length:255The display value corresponding to the parent entity name lookup code for the action. -
StripeCd: string
Title:
Stripe CodeMaximum Length:30The application context of the action. -
StripeCdMeaning: string
Title:
Stripe ValueMaximum Length:255The display value corresponding to the stripe lookup code for the action. -
UseDefaultVersionFlag: boolean
Title:
Use Default VersionMaximum Length:1Default Value:falseIndicates whether the default process version is used. -
VisibilityCd: string
Title:
VisibilityMaximum Length:30Default Value:ORA_SVC_NOT_PUBLISHEDThe code indicating the visibility level of the action. A list of valid values is defined in the lookup ORA_SVC_AP_VISIBILITY_CD. -
VisibilityCdMeaning: string
Title:
Visibility ValueMaximum Length:255The display value corresponding to the visibility lookup code for the action.
Nested Schema : Action Attributes
Type:
arrayTitle:
Action AttributesThe action attributes resource is used to view, create, update, and delete the attributes that are set while creating or updating the related object of an action.
Show Source
Nested Schema : Action Conditions
Type:
arrayTitle:
Action ConditionsThe action conditions resource is used to view, create, update, and delete the definitions of the status mapping conditions for the related object of an action.
Show Source
Nested Schema : schema
Type:
Show Source
object-
AttributeValue: string
Title:
Attribute ValueMaximum Length:1000The value to be set for the action attribute. -
AttributeValueContextCd: string
Title:
ContextMaximum Length:30Default Value:ORA_SVC_USER_DEFINEDThe code indicating the context within which the attribute value is interpreted. A list of valid values is defined in the lookup ORA_SVC_AP_CONTEXT_CD. -
AttributeValueContextCdMeaning: string
Title:
Context ValueMaximum Length:255The display value corresponding to the context lookup code for the action attribute. -
ChildAttributeFlag: boolean
Title:
Child Attribute IndicatorMaximum Length:1Default Value:falseIndicates whether this attribute belongs to the parent or one of its child objects. -
DeletedFlag: boolean
Title:
DeletedMaximum Length:1Default Value:falseIndicates whether the attribute action is deleted. The default value is false. -
UsageCd: string
Title:
UsageMaximum Length:30Default Value:ORA_SVC_CREATEThe code indicating when the attribute is to be used. A list of valid values is defined in the lookup ORA_SVC_AP_ATTRIBUTE_USAGE_CD. -
UsageCdMeaning: string
Title:
Usage ValueMaximum Length:255The display value corresponding to the usage lookup code for the action attribute.
Nested Schema : schema
Type:
Show Source
object-
ActionStatusCd: string
Title:
Action StatusMaximum Length:30The code indicating the status of the action based on whether the condition is met or not. A list of valid values is defined in the lookup ORA_SVC_AP_STATUS_CD. -
ActionStatusCdMeaning: string
Title:
Action Status ValueMaximum Length:255The display value corresponding to the action status lookup code for the action condition. -
CompletionFlag: boolean
Title:
CompletionFlagMaximum Length:1Indicates whether the action was completed by fulfilling the condition. The default value is false. -
Condition: string
Title:
ConditionMaximum Length:1000The expression indicating whether the condition is met or not. -
Description: string
Title:
DescriptionMaximum Length:1000The description of the action condition. -
Name: string
Title:
NameMaximum Length:400The name of the action condition.
Response
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : actions-item-response
Type:
Show Source
object-
actionAttribute: array
Action Attributes
Title:
Action AttributesThe action attributes resource is used to view, create, update, and delete the attributes that are set while creating or updating the related object of an action. -
ActionCategoryCd: string
Title:
CategoryMaximum Length:30The code indicating the category of the action. A list of valid values is defined in the lookup ORA_SVC_AP_ACTION_CATEGORY_CD. -
ActionCategoryCdMeaning: string
Title:
Action Category ValueMaximum Length:255The display value corresponding to the action category lookup code for the action. -
actionCondition: array
Action Conditions
Title:
Action ConditionsThe action conditions resource is used to view, create, update, and delete the definitions of the status mapping conditions for the related object of an action. -
ActionId: integer
(int64)
Title:
Action IDThe unique identifier of the action. -
ActionNumber: string
Title:
Action NumberMaximum Length:64The alternate unique identifier of the action. -
BUOrgId: integer
(int64)
Title:
Business Unit IDThe unique identifier of the business unit name associated to the action. -
BusinessUnitName: string
Title:
Business Unit IDThe name of the business unit associated to the action. -
CopyAttachmentsFlag: boolean
Title:
Copy AttachmentsMaximum Length:1Default Value:falseIndicates whether the attachments are copied from the parent context to the child object. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the action. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time when the action was created. -
DeletedFlag: boolean
Title:
DeletedMaximum Length:1Default Value:falseIndicates whether the action is deleted. The default value is false. -
DeleteFlag: boolean
Read Only:
trueIndicates whether the action can be deleted. -
Description: string
Title:
DescriptionMaximum Length:1000The description of the action. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date and time when the action was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the action. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the action. -
LeadTime: integer
(int64)
Title:
DurationThe estimated time required to complete the action. -
LeadTimeUnit: string
Title:
Duration UnitMaximum Length:30The unit of measurement of the lead time, such as minutes, hours, or days. -
LeadTimeUnitMeaning: string
Title:
Lead Time Unit ValueMaximum Length:255The display value corresponding to the lead time unit lookup code for the action. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
ActionMaximum Length:400The name of the action. -
ObjectEntityName: string
Title:
Entity NameMaximum Length:400The entity name of the object on which the action is based. -
ObjectEntityNameMeaning: string
Title:
Object Entity Name ValueMaximum Length:255The display value corresponding to the object entity name lookup code for the action. -
ObjectEntitySubtype: string
Title:
Object Entity SubtypeMaximum Length:400Indicates the subtype of the object on which the action is based. -
ObjectEntityType: string
Title:
TypeMaximum Length:400The type of the entity object on which the action is based. -
ObjectEntityTypeMeaning: string
Title:
Object Entity Type ValueMaximum Length:255The display value corresponding to the object entity type lookup code for the action. -
ObjectLinkTypeId: integer
(int64)
Title:
Object Link Type IdThe object link type identifier associated to the action. -
ObjectLinkTypeNumber: string
Title:
Link Type NumberMaximum Length:255The public unique identifier of the object link type associated with the action. -
OperationCd: string
Title:
Operation CodeMaximum Length:30The operation code entry for the action. A list of valid values is defined in the lookup ORA_SVC_AP_OPERATION_CD. -
OperationCdMeaning: string
Title:
Operation ValueMaximum Length:255The display value corresponding to the operation lookup code for the action. -
OriginalSystemReference: string
Title:
Original System ReferenceMaximum Length:255The reference to the original system from which the action was imported (if imported). -
ParentEntityName: string
Title:
ContextMaximum Length:400The entity name of the object on which the action is used. -
ParentEntityNameMeaning: string
Title:
Parent Entity Name ValueMaximum Length:255The display value corresponding to the parent entity name lookup code for the action. -
ProcessConnectionTypeCd: string
Title:
Process Connection Type CodeRead Only:trueMaximum Length:30Default Value:IntegratedThe lookup code that indicates if the connection to Process Cloud is basic or integrated. -
ProcessMetadataId: integer
(int64)
Title:
Process Metadata IDThe unique identifier of the process metadata. -
ProcessMetadataNumber: string
Title:
Process Metadata NumberMaximum Length:30The reference number of the process metadata. -
StripeCd: string
Title:
Stripe CodeMaximum Length:30The application context of the action. -
StripeCdMeaning: string
Title:
Stripe ValueMaximum Length:255The display value corresponding to the stripe lookup code for the action. -
UpdateFlag: boolean
Read Only:
trueIndicates whether the action can be updated. -
UseDefaultVersionFlag: boolean
Title:
Use Default VersionMaximum Length:1Default Value:falseIndicates whether the default process version is used. -
VisibilityCd: string
Title:
VisibilityMaximum Length:30Default Value:ORA_SVC_NOT_PUBLISHEDThe code indicating the visibility level of the action. A list of valid values is defined in the lookup ORA_SVC_AP_VISIBILITY_CD. -
VisibilityCdMeaning: string
Title:
Visibility ValueMaximum Length:255The display value corresponding to the visibility lookup code for the action.
Nested Schema : Action Attributes
Type:
arrayTitle:
Action AttributesThe action attributes resource is used to view, create, update, and delete the attributes that are set while creating or updating the related object of an action.
Show Source
Nested Schema : Action Conditions
Type:
arrayTitle:
Action ConditionsThe action conditions resource is used to view, create, update, and delete the definitions of the status mapping conditions for the related object of an action.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : actions-actionAttribute-item-response
Type:
Show Source
object-
ActionAttributeId: integer
(int64)
Title:
Action Attribute IDRead Only:trueThe unique identifier of the action attribute. -
ActionId: integer
(int64)
Title:
Action IDThe unique identifier of the action. -
ActionNumber: string
Title:
Action NumberMaximum Length:64The alternate unique identifier of the action. -
AttributeName: string
Title:
Attribute NameMaximum Length:2000The name of the action attribute. -
AttributeValue: string
Title:
Attribute ValueMaximum Length:1000The value to be set for the action attribute. -
AttributeValueContextCd: string
Title:
ContextMaximum Length:30Default Value:ORA_SVC_USER_DEFINEDThe code indicating the context within which the attribute value is interpreted. A list of valid values is defined in the lookup ORA_SVC_AP_CONTEXT_CD. -
AttributeValueContextCdMeaning: string
Title:
Context ValueMaximum Length:255The display value corresponding to the context lookup code for the action attribute. -
ChildAttributeFlag: boolean
Title:
Child Attribute IndicatorMaximum Length:1Default Value:falseIndicates whether this attribute belongs to the parent or one of its child objects. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the action attribute. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time when the action attribute was created. -
DeletedFlag: boolean
Title:
DeletedMaximum Length:1Default Value:falseIndicates whether the attribute action is deleted. The default value is false. -
DeleteFlag: boolean
Read Only:
trueIndicates whether the action attribute can be deleted. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date and time when the action attribute was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the action attribute. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the action attribute. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
UpdateFlag: boolean
Read Only:
trueIndicates whether the action attribute can be updated. -
UsageCd: string
Title:
UsageMaximum Length:30Default Value:ORA_SVC_CREATEThe code indicating when the attribute is to be used. A list of valid values is defined in the lookup ORA_SVC_AP_ATTRIBUTE_USAGE_CD. -
UsageCdMeaning: string
Title:
Usage ValueMaximum Length:255The display value corresponding to the usage lookup code for the action attribute.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : actions-actionCondition-item-response
Type:
Show Source
object-
ActionConditionId: integer
(int64)
Title:
Action Condition IDRead Only:trueThe unique identifier of the action condition. -
ActionId: integer
(int64)
Title:
Action IDThe unique identifier of the action. -
ActionNumber: string
Title:
Action NumberMaximum Length:64The alternate unique identifier of the action. -
ActionStatusCd: string
Title:
Action StatusMaximum Length:30The code indicating the status of the action based on whether the condition is met or not. A list of valid values is defined in the lookup ORA_SVC_AP_STATUS_CD. -
ActionStatusCdMeaning: string
Title:
Action Status ValueMaximum Length:255The display value corresponding to the action status lookup code for the action condition. -
CompletionFlag: boolean
Title:
CompletionFlagMaximum Length:1Indicates whether the action was completed by fulfilling the condition. The default value is false. -
Condition: string
Title:
ConditionMaximum Length:1000The expression indicating whether the condition is met or not. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the action condition. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date and time when the condition was created. -
DeleteFlag: boolean
Read Only:
trueIndicates whether the action condition can be deleted. -
Description: string
Title:
DescriptionMaximum Length:1000The description of the action condition. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date and time when the action condition was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the action condition. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login details of the user who last updated the action condition. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
Name: string
Title:
NameMaximum Length:400The name of the action condition. -
UpdateFlag: boolean
Read Only:
trueIndicates whether the action condition can be updated.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- ActionCategoryCdlookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_ACTION_CATEGORY_CD
The list of values indicating the category code on an action.
The following properties are defined on the LOV link relation:- Source Attribute: ActionCategoryCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ActionVisibilityCdLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_VISIBILITY_CD
The list of values indicating the visibility status of an action.
The following properties are defined on the LOV link relation:- Source Attribute: VisibilityCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- BusinessUnitLOV
-
The list of values indicating the business unit name.
The following properties are defined on the LOV link relation:- Source Attribute: BusinessUnitName; Target Attribute: Name
- Display Attribute: Name
- LeadTimeUnitLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_LEAD_TIME_UNIT
The list of values indicating the units of measurement of the time required to complete an action.
The following properties are defined on the LOV link relation:- Source Attribute: LeadTimeUnit; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ObjectEntityNameLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_OBJ_ENTITY_NAME
The list of entity object on which the action is based.
The following properties are defined on the LOV link relation:- Source Attribute: ObjectEntityName; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ObjectEntityTypeLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_OBJ_ENTITY_TYPE
The list of values indicating the type of the entity object on which the action is based.
The following properties are defined on the LOV link relation:- Source Attribute: ObjectEntityType; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ObjectLinkTypeLOV
-
The list of values indicating the object link type for the action.
The following properties are defined on the LOV link relation:- Source Attribute: ObjectLinkTypeId; Target Attribute: LinkTypeId
- Display Attribute: Name
- OperationCdLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_OPERATION_CD
The list of values indicating the operation code entry for the action.
The following properties are defined on the LOV link relation:- Source Attribute: OperationCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ParentEntityNameLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_PARENT_ENTITY_NAME
The list of values indicating the entity name on which the created action object will be used.
The following properties are defined on the LOV link relation:- Source Attribute: ParentEntityName; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- ProcessConnectionTypeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_AP_PCS_CONNECTION_TYPE
The following properties are defined on the LOV link relation:- Source Attribute: ProcessConnectionTypeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- StripeCdLOV
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_STRIPE_CD
The list of values indicating the application context of the action.
The following properties are defined on the LOV link relation:- Source Attribute: StripeCd; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- YesNoLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DYES_NO
The list of values indicating whether attachments are copied to child objects from the context.
The following properties are defined on the LOV link relation:- Source Attribute: CopyAttachmentsFlag; Target Attribute: LookupCode
- Display Attribute: Meaning
- finder:
- actionAttribute
-
Parameters:
- ActionNumber:
$request.path.ActionNumber
The action attributes resource is used to view, create, update, and delete the attributes that are set while creating or updating the related object of an action. - ActionNumber:
- actionCondition
-
Parameters:
- ActionNumber:
$request.path.ActionNumber
The action conditions resource is used to view, create, update, and delete the definitions of the status mapping conditions for the related object of an action. - ActionNumber:
Examples
The following example shows how to update an action by submitting a PATCH request on the REST resource using cURL.
cURL Command
curl -u <username:password> \ -X PATCH -d
@example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/actions/ACT0000044367
Example of Request Body
The following example shows the contents of the request body in JSON format.
{
"Name" : "AcP_Rest44",
"VisibilityCd" : "ORA_SVC_CUSTOMER_VISIBLE"
}Example of Response Body
The following example shows the contents of the response body in JSON format.
{
"ActionCategoryCd": "CATEGORY 1",
"ActionId": 300100118621756,
"CreatedBy": "xuidrill2",
"CreationDate": "2017-09-25T06:38:02+00:00",
"DeletedFlag": false,
"Description": "SR IN Progress to Blocked when Severity is HIGH",
"LastUpdateDate": "2017-09-27T12:50:07+00:00",
"LastUpdateLogin": "5A2BD805BC436ED2E0538E09F20A9D1F",
"LastUpdatedBy": "SALES_ADMIN",
"LeadTime": 45,
"LeadTimeUnit": "ORA_SVC_MINS",
"Name": "AcP_Rest44",
"ObjectEntityName": "ServiceRequest",
"ParentEntityName": "ServiceRequest",
"VisibilityCd": "ORA_SVC_CUSTOMER_VISIBLE",
"OperationCd": "ORA_SVC_CREATE",
"ObjectEntityType": "ServiceRequest",
"ActionNumber": "ACT0000044367",
"OriginalSystemReference": "ACT0000044367",
"DeleteFlag": true,
"UpdateFlag": true,
"DclAction_Id_c": null,
"DclAction_c": null,
"links": [
...
]
}