Approve
Approve
post/api/v1/tasks/{task_id}/action/approve
Invokes the c1.api.task.v1.TaskActionsService.Approve method.
Path Parameters
task_idstring
The ID of the task to approve.
Body Parameters
policyStepIdstring
The ID of the policy step on the given task to approve.
commentstring
optional
The comment attached to the request.
The task expand mask is an array of strings that specifes the related objects the requester wishes to have returned when making a request where the expand mask is part of the input. Use '*' to view all possible responses.
Returns
expandedarray of object
optional
List of serialized related objects.
taskViewaccessReviewPathstringappPathstringappUserPathstringcreatedByUserPathstringentitlementsPathstringidentityUserPathstringinsightsPathstringstepApproversPathstringtaskobjectuserPathstringTaskView
optional
Contains a task and JSONPATH expressions that describe where in the expanded array related objects are located. This view can be used to display a fully-detailed dashboard of task information.
ticketActionIdstring
optional
The ID of the ticket (task) approve action created by this request.
Request example cURL
curl https://{tenantDomain}.conductor.one/api/v1/tasks/$TASK_ID/action/approve \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CONDUCTORONE_SDK_API_KEY" \
-d '{
"policyStepId": "policyStepId"
}'200 Example
{
"taskView": {
"task": {
"insightIds": [
"string"
],
"origin": "TASK_ORIGIN_UNSPECIFIED",
"policy": {
"current": {
"accept": {
"acceptMessage": "acceptMessage"
},
"approval": {
"approval": {
"agent": {
"agentMode": "APPROVAL_AGENT_MODE_UNSPECIFIED",
"agentUserId": "agentUserId",
"instructions": "instructions",
"policyIds": [
"string"
]
},
"allowedReassignees": [
"string"
],
"allowReassignment": true,
"appOwners": {
"allowSelfApproval": true
},
"entitlementOwners": {
"allowSelfApproval": true,
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"escalation": {
"escalationComment": "escalationComment",
"expiration": "expiration",
"reassignToApprovers": {
"approverIds": [
"string"
]
},
"replacePolicy": {
"policyId": "policyId"
}
},
"escalationEnabled": true,
"expression": {
"allowSelfApproval": true,
"expressions": [
"string"
],
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"group": {
"allowSelfApproval": true,
"appGroupId": "appGroupId",
"appId": "appId",
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"manager": {
"allowSelfApproval": true,
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"requireApprovalReason": true,
"requireDenialReason": true,
"requireReassignmentReason": true,
"requiresStepUpProviderId": "requiresStepUpProviderId",
"resourceOwners": {
"allowSelfApproval": true,
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"self": {
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"users": {
"allowSelfApproval": true,
"userIds": [
"string"
]
},
"webhook": {
"webhookId": "webhookId"
}
},
"approved": {},
"denied": {},
"escalationInstance": {
"alreadyEscalated": true,
"escalationComment": "escalationComment",
"expiresAt": "2019-12-27T18:11:19.117Z",
"reassignToApprovers": {
"approverIds": [
"string"
]
},
"replacePolicy": {
"policyId": "policyId"
}
},
"reassigned": {},
"reassignedByError": {},
"restarted": {},
"skipped": {}
},
"policyGenerationId": "policyGenerationId",
"provision": {
"cancelled": {
"cancelledAt": "2019-12-27T18:11:19.117Z",
"cancelledByUserId": "cancelledByUserId"
},
"completed": {
"completedAt": "2019-12-27T18:11:19.117Z",
"entitlements": [
{
"appEntitlementId": "appEntitlementId",
"appId": "appId"
}
],
"userId": "userId"
},
"errored": {
"description": "description",
"errorCode": "errorCode",
"erroredAt": "2019-12-27T18:11:19.117Z"
},
"externalTicketId": "externalTicketId",
"externalTicketProvisionerConfigId": "externalTicketProvisionerConfigId",
"notificationId": "notificationId",
"provision": {
"assigned": true,
"provisionPolicy": {
"connector": {
"account": {
"config": {
"foo": "bar"
},
"connectorId": "connectorId",
"doNotSave": {},
"saveToVault": {
"vaultIds": [
"string"
]
},
"schemaId": "schemaId"
},
"defaultBehavior": {
"connectorId": "connectorId"
},
"deleteAccount": {
"connectorId": "connectorId"
}
},
"delegated": {
"appId": "appId",
"entitlementId": "entitlementId",
"implicit": true
},
"externalTicket": {
"appId": "appId",
"connectorId": "connectorId",
"externalTicketProvisionerConfigId": "externalTicketProvisionerConfigId",
"instructions": "instructions"
},
"manual": {
"instructions": "instructions",
"userIds": [
"string"
]
},
"unconfigured": {},
"webhook": {
"webhookId": "webhookId"
}
},
"provisionTarget": {
"appEntitlementId": "appEntitlementId",
"appId": "appId",
"appUserId": "appUserId",
"grantDuration": "grantDuration"
}
},
"reassignedByError": {},
"skipped": {},
"state": "PROVISION_INSTANCE_STATE_UNSPECIFIED",
"webhookId": "webhookId",
"webhookInstanceId": "webhookInstanceId"
},
"reject": {
"rejectMessage": "rejectMessage"
},
"wait": {
"commentOnFirstWait": "commentOnFirstWait",
"commentOnTimeout": "commentOnTimeout",
"condition": {
"condition": "condition"
},
"name": "name",
"skipped": {},
"startedWaitingAt": "2019-12-27T18:11:19.117Z",
"state": "WAIT_INSTANCE_STATE_UNSPECIFIED",
"succeeded": {
"succeededAt": "2019-12-27T18:11:19.117Z"
},
"timedOut": {
"timedOutAt": "2019-12-27T18:11:19.117Z"
},
"timeout": "2019-12-27T18:11:19.117Z",
"timeoutDuration": "timeoutDuration"
}
},
"policy": {
"description": "description",
"displayName": "displayName",
"policySteps": {
"foo": {
"steps": [
{
"accept": {
"acceptMessage": "acceptMessage"
},
"approval": {
"agent": {
"agentMode": "APPROVAL_AGENT_MODE_UNSPECIFIED",
"agentUserId": "agentUserId",
"instructions": "instructions",
"policyIds": [
"string"
]
},
"allowedReassignees": [
"string"
],
"allowReassignment": true,
"appOwners": {
"allowSelfApproval": true
},
"entitlementOwners": {
"allowSelfApproval": true,
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"escalation": {
"escalationComment": "escalationComment",
"expiration": "expiration",
"reassignToApprovers": {
"approverIds": [
"string"
]
},
"replacePolicy": {
"policyId": "policyId"
}
},
"escalationEnabled": true,
"expression": {
"allowSelfApproval": true,
"expressions": [
"string"
],
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"group": {
"allowSelfApproval": true,
"appGroupId": "appGroupId",
"appId": "appId",
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"manager": {
"allowSelfApproval": true,
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"requireApprovalReason": true,
"requireDenialReason": true,
"requireReassignmentReason": true,
"requiresStepUpProviderId": "requiresStepUpProviderId",
"resourceOwners": {
"allowSelfApproval": true,
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"self": {
"fallback": true,
"fallbackUserIds": [
"string"
]
},
"users": {
"allowSelfApproval": true,
"userIds": [
"string"
]
},
"webhook": {
"webhookId": "webhookId"
}
},
"provision": {
"assigned": true,
"provisionPolicy": {
"connector": {
"account": {
"config": {
"foo": "bar"
},
"connectorId": "connectorId",
"doNotSave": {},
"saveToVault": {
"vaultIds": [
"string"
]
},
"schemaId": "schemaId"
},
"defaultBehavior": {
"connectorId": "connectorId"
},
"deleteAccount": {
"connectorId": "connectorId"
}
},
"delegated": {
"appId": "appId",
"entitlementId": "entitlementId",
"implicit": true
},
"externalTicket": {
"appId": "appId",
"connectorId": "connectorId",
"externalTicketProvisionerConfigId": "externalTicketProvisionerConfigId",
"instructions": "instructions"
},
"manual": {
"instructions": "instructions",
"userIds": [
"string"
]
},
"unconfigured": {},
"webhook": {
"webhookId": "webhookId"
}
},
"provisionTarget": {
"appEntitlementId": "appEntitlementId",
"appId": "appId",
"appUserId": "appUserId",
"grantDuration": "grantDuration"
}
},
"reject": {
"rejectMessage": "rejectMessage"
},
"wait": {
"commentOnFirstWait": "commentOnFirstWait",
"commentOnTimeout": "commentOnTimeout",
"condition": {
"condition": "condition"
},
"name": "name",
"timeoutDuration": "timeoutDuration"
}
}
]
}
},
"policyType": "POLICY_TYPE_UNSPECIFIED",
"postActions": [
{
"certifyRemediateImmediately": true
}
],
"reassignTasksToDelegates": true,
"rules": [
{
"condition": "condition",
"policyKey": "policyKey"
}
]
}
},
"recommendation": "INSIGHT_RECOMMENDATION_UNSPECIFIED",
"type": {
"certify": {},
"grant": {
"source": {
"externalUrl": "externalUrl",
"integrationId": "integrationId",
"requestId": "requestId"
}
},
"offboarding": {},
"revoke": {
"source": {
"expired": {
"expiredAt": "2019-12-27T18:11:19.117Z"
},
"nonUsage": {
"expiresAt": "2019-12-27T18:11:19.117Z",
"lastLogin": "2019-12-27T18:11:19.117Z"
},
"request": {
"requestUserId": "requestUserId"
},
"review": {
"accessReviewId": "accessReviewId",
"certTicketId": "certTicketId"
}
}
}
}
}
}
}