Update an orchestration stage

patch

/crmRestApi/resources/11.13.18.05/orchestrations/{OrchestrationNumber}/child/Stages/{OrchestrationStageNumber}

Request

Path Parameters
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
  • The value of this parameter could be a hash of the key that is used to uniquely identify the resource item. The client should not generate the hash key value. Instead, the client should query on the collection resource with a filter to navigate to a specific resource item. For example: products?q=InventoryItemId=
Header Parameters
  • 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".
  • 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
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Contain Errors
    Maximum Length: 1
    Indicates whether the orchestration stage contains any validation errors.
  • Title: Display Sequence
    The order of the orchestration stages in the orchestration administrator run time user interfaces.
  • Title: Objective Description
    Maximum Length: 2000
    The description text of the orchestration stage object.
  • Title: Stage Name
    Maximum Length: 100
    The name of the orchestration stage.
  • Stage Objectives
    Title: Stage Objectives
    The stage objectives resource is used to view, create, update, and delete a stage objective. It's a free form of goals to achieve in a particular stage.
  • Step Objective Associations
    Title: Step Objective Associations
    The step objective associations resource is used to view, create, update, and delete a step objective association. It's the objective of performing a step. One step can be mapped to multiple objectives.
  • Steps
    Title: Steps
    The steps resource is used to view, create, update, and delete a step. Steps are individual action items such as execute a smart action, send an email, make a phone call, and so on.
  • Step Tasks
    Title: Step Tasks
    Step tasks contains the list of tasks and their related information for a given step.
Nested Schema : Stage Objectives
Type: array
Title: Stage Objectives
The stage objectives resource is used to view, create, update, and delete a stage objective. It's a free form of goals to achieve in a particular stage.
Show Source
Nested Schema : Step Objective Associations
Type: array
Title: Step Objective Associations
The step objective associations resource is used to view, create, update, and delete a step objective association. It's the objective of performing a step. One step can be mapped to multiple objectives.
Show Source
Nested Schema : Steps
Type: array
Title: Steps
The steps resource is used to view, create, update, and delete a step. Steps are individual action items such as execute a smart action, send an email, make a phone call, and so on.
Show Source
Nested Schema : Step Tasks
Type: array
Title: Step Tasks
Step tasks contains the list of tasks and their related information for a given step.
Show Source
Nested Schema : orchestrations-Stages-StageObjectives-item-patch-request
Type: object
Show Source
Nested Schema : orchestrations-Stages-StepObjectivesAssociations-item-patch-request
Type: object
Show Source
Nested Schema : orchestrations-Stages-Steps-item-patch-request
Type: object
Show Source
Nested Schema : orchestrations-Stages-StepTasks-item-patch-request
Type: object
Show Source
  • Title: Allow Step Skipping
    Maximum Length: 1
    Default Value: true
    Indicates whether or not to show skip or thumbs down icon in the guidance primary or secondary banner.
  • Title: Assigned To
    Maximum Length: 30
    Default Value: OWNER
    Indicates to whom the activity should be assigned to when it's generated. Possible values are OWNER, TEAM MEMBER, and CUSTOM CONDITION.
  • Title: Assigned to Rule
    The rule when AssignedTo is specified as CUSTOM_CONDITION.
  • Title: Display Sequence
    The order of the steps in the orchestration administrator runtime UIs.
  • Title: Email Template ID
    The unique identifier of the email template that will be defaulted at run time.
  • Title: Evaluate on Marked as Completed
    Maximum Length: 1
    Default Value: false
    Indicates whether or not to evaluate the success criteria when a task or an appointment is marked as complete.
  • Title: Field Update JSON
    The JSON structure containing the list of fields to update on source object.
  • Title: Grace Period
    Specifies the number of hours to wait before treating the Step as failed. This is applicable only for manual steps.
  • Title: IA Template Value
    Maximum Length: 100
    The name of the intelligent advisor guide template.
  • Title: Smart Action ID
    The unique identifier of the smart action.
  • Title: Wait for Replies Flag
    Maximum Length: 1
    Default Value: false
    Indicates whether the step has to wait for replies.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : orchestrations-Stages-item-response
Type: object
Show Source
Nested Schema : Stage Objectives
Type: array
Title: Stage Objectives
The stage objectives resource is used to view, create, update, and delete a stage objective. It's a free form of goals to achieve in a particular stage.
Show Source
Nested Schema : Step Objective Associations
Type: array
Title: Step Objective Associations
The step objective associations resource is used to view, create, update, and delete a step objective association. It's the objective of performing a step. One step can be mapped to multiple objectives.
Show Source
Nested Schema : Steps
Type: array
Title: Steps
The steps resource is used to view, create, update, and delete a step. Steps are individual action items such as execute a smart action, send an email, make a phone call, and so on.
Show Source
Nested Schema : Step Tasks
Type: array
Title: Step Tasks
Step tasks contains the list of tasks and their related information for a given step.
Show Source
Nested Schema : orchestrations-Stages-StageObjectives-item-response
Type: object
Show Source
Nested Schema : orchestrations-Stages-StepObjectivesAssociations-item-response
Type: object
Show Source
Nested Schema : orchestrations-Stages-Steps-item-response
Type: object
Show Source
Nested Schema : orchestrations-Stages-StepTasks-item-response
Type: object
Show Source
Back to Top