Create Tasks
Search
Search tasks based on filters specified in the request body.
Body Parameters
Search tasks that belong to any of the access reviews included in this list.
Search tasks that have any of these account owners.
The accountTypes field.
Search tasks that have this actor ID.
Search tasks that have any of these app entitlement IDs.
Search tasks that have any of these apps as targets.
Search tasks that have any of these app resource IDs.
Search tasks that have any of these app resource type IDs.
Search tasks that have any of these app users as subjects.
Search tasks that are currently assigned to this user, or that are closed and were previously approved by this user.
Search tasks by List of UserIDs which are currently assigned these Tasks
Search tasks that have this type of step as the current step.
Search tasks that are or are not emergency access.
Search tasks that do not have any of these app entitlement IDs.
Search tasks that do not have any of these app resource type IDs.
Exclude Specific TaskIDs from this serach result.
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.
Whether or not to include deleted tasks.
Search tasks where the user would see this task in the My Work section
Search tasks that were created by any of the users in this array.
Search tasks that were opened by this user, or that the user is the subject of.
The pageSize where 0 <= pageSize <= 100. Values < 10 will be set to 10. A value of 0 returns the default page size (currently 25)
The pageToken field.
Search tasks that were acted on by any of these users.
Fuzzy search tasks by display name or description. Also can search by numeric ID.
Query tasks by display name, description, or numeric ID.
Sort tasks in a specific order.
Search tasks that have a current policy step of this type
Search tasks where these users are the subject.
Search tasks with this task state.
Search tasks with this task type. This is a oneOf, and needs an object, which can be empty, to sort.
The userEmploymentStatuses field.
Returns
The list of results containing up to X results, where X is the page size defined in the request.
List of serialized related objects.
The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retreived. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.
curl https://{tenantDomain}.conductor.one/api/v1/search/tasks \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $CONDUCTORONE_SDK_API_KEY"{
"expanded": [
{
"@type": "@type"
}
],
"list": [
{
"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"
}
}
}
}
}
}
],
"nextPageToken": "nextPageToken"
}