Update Workflow Group
https://api.signinghub.com/v3/packages/{package_id}/workflow/{order}/group |
||
HTTP Verb |
PUT |
|
Content-Type |
application/json |
|
Accept |
application/json |
|
Authorization |
Bearer {access_token} |
|
Request Body |
{
"group_name" : "Technical Support" , "role" : "SIGNER" , "email_notification" : true, }
|
|
Status Code |
Message |
Response Body |
200 |
OK |
|
400 | Bad Request |
{ "Message" : "Recipient role is not supported for an XML type document" } |
401 |
Unauthorized |
{ "Message" : "Request authorization denied" } |
{ "Message" : "User authentication required" } |
||
403 |
Forbidden |
{ "Message" : "Document does not belong to user" } |
{ "Message" : "You are not allowed to perform this action on locked workflow" } |
||
{ "Message" : "You are not allowed to perform the requested operation" } |
||
{ "Message" : "You cannot access this document after the access period ends" } |
||
{ "Message" : "Account is disabled" } |
||
{ "Message" : "You are not allowed to perform the requested operation" } |
||
404 |
Not Found |
{ "Message" : "Document not found" } |
{ "Message" : "No group found at given order" } |
||
500 |
Internal Server Error |
{ "Message" : "An internal server error occurred while processing the request" } |
Item Details | |
Names |
Description |
Request Parameters |
|
access_token | The access token obtained as a result of successful authentication. If "scope" parameter was used in authentication request, then this service requires the access token to be obtained using the credentials of an Enterprise admin whose enterprise role has the application integration privileges. |
package_id |
The package ID for which workflow group needs to be updated. |
order | The order of the user in workflow. |
group_name (optional) |
The name of the group to be updated in workflow. If no value is provided, old value will be retained. |
role (optional) | Role of the group as a recipient in the workflow. Possible value are "SIGNER", "REVIEWER", "EDITOR","CARBON_COPY" and "INPERSON_HOST". If no value is provided, old value will be retained. However, while XML type document preparation, only supported role types are "SIGNER", "REVIEWER" and "CARBON_COPY" |
email_notification (optional) |
Setting its value to "true" sends an email notification to the group members when their turn arrives in workflow. Setting its value to "false" does not send the email notification to the group members on their turn. If no value is provided, old value will be retained. |
signing_order (optional) | Order in which the workflow will be signed by the recipients. This signing order is important when workflow type is set to "CUSTOM". |
Response Parameters | |
Message | The service specific error message returned by the API. This message provides useful information about why the service has returned an error response. |