PartnerCentralSellingAPI / Client / list_prospecting_from_engagement_tasks

list_prospecting_from_engagement_tasks¶

PartnerCentralSellingAPI.Client.list_prospecting_from_engagement_tasks(**kwargs)¶

Lists all prospecting tasks initiated by the caller’s account. Supports optional filters by task identifier, task name, or start time range. Results can be sorted using configurable options. The response is paginated. Use the NextToken value from each response to retrieve subsequent pages.

Request Syntax

response = client.list_prospecting_from_engagement_tasks(
    Catalog='string',
    MaxResults=123,
    NextToken='string',
    TaskIdentifier=[
        'string',
    ],
    TaskName=[
        'string',
    ],
    StartAfter=datetime(2015, 1, 1),
    StartBefore=datetime(2015, 1, 1),
    Sort={
        'SortOrder': 'ASCENDING'|'DESCENDING',
        'SortBy': 'StartTime'|'TaskName'|'FailedEngagementCount'
    }
)

Parameters:

Catalog (string) –
[REQUIRED]

Specifies the catalog to list tasks from. Specify AWS for production environments and Sandbox for testing and development purposes.
MaxResults (integer) – The maximum number of results to return in a single page. If additional results exist, the response includes a NextToken value for retrieving the next page. If omitted, the API uses a service-defined default page size.
NextToken (string) – The pagination token from a previous call to this API. Include this value to retrieve the next page of results. If omitted, the first page is returned.
TaskIdentifier (list) –
Filters the results to include only the tasks with the specified identifiers. Provide up to 10 task IDs to narrow the list to specific tasks. If omitted, tasks are not filtered by identifier.
- (string) –
TaskName (list) –
Filters the results to include only tasks with the specified names. Provide up to 10 task names to narrow the list. If omitted, tasks are not filtered by name.
- (string) –
StartAfter (datetime) – Filters tasks to include only those that started after the specified timestamp. Use this with StartBefore to define a start-time range for your query. The format follows ISO 8601 date-time notation.
StartBefore (datetime) – Filters tasks to include only those that started before the specified timestamp. Use this with StartAfter to define a start-time range for your query. The format follows ISO 8601 date-time notation.
Sort (dict) –
Specifies the field and order used to sort the returned tasks. If omitted, tasks are returned in the default sort order.
- SortOrder (string) – [REQUIRED]
  
  The direction in which to sort the results. Use ASCENDING to return the smallest or earliest values first, or DESCENDING to return the largest or most recent values first.
- SortBy (string) – [REQUIRED]
  
  The field by which to sort the returned tasks. Valid values: StartTime (task creation timestamp), TaskName (alphabetically by task name), and FailedEngagementCount (number of failed engagements).

Return type:

dict

Returns:

Response Syntax

{
    'NextToken': 'string',
    'TaskSummaries': [
        {
            'TaskId': 'string',
            'TaskArn': 'string',
            'TaskName': 'string',
            'StartTime': datetime(2015, 1, 1),
            'EndTime': datetime(2015, 1, 1),
            'TotalEngagementCount': 123,
            'CompletedEngagementCount': 123,
            'FailedEngagementCount': 123
        },
    ]
}

Response Structure

(dict) –

Represents the response structure containing a paginated list of prospecting task summaries matching the request filters. Indicates through NextToken when additional results are available.
- NextToken (string) –
  
  A pagination token used to retrieve the next page of results. If this field is present, pass its value as NextToken in the next call. If absent or empty, there are no further pages.
- TaskSummaries (list) –
  
  Prospecting task summaries matching the specified filters. Each summary includes the task identifier, name, status counters, and timing information. If no tasks match the filter criteria, the list is empty.
  - (dict) –
    
    A summary of a single prospecting task, returned by ListProspectingFromEngagementTasks. Contains key metrics and status information without the full per-engagement detail available from GetProspectingFromEngagementTask.
    - TaskId (string) –
      
      The unique identifier of the task. Use this value with GetProspectingFromEngagementTask to retrieve full task details.
    - TaskArn (string) –
      
      The Amazon Resource Name (ARN) of the task.
    - TaskName (string) –
      
      The descriptive name of the task provided when it was created.
    - StartTime (datetime) –
      
      The timestamp indicating when the task was initiated. The format follows ISO 8601 date-time notation.
    - EndTime (datetime) –
      
      The timestamp indicating when the task finished processing. This field is absent if the task is still in progress. The format follows ISO 8601 date-time notation.
    - TotalEngagementCount (integer) –
      
      The total number of engagements included in the task.
    - CompletedEngagementCount (integer) –
      
      The number of engagements that have been successfully converted into prospecting leads.
    - FailedEngagementCount (integer) –
      
      The number of engagements that failed to be converted. Retrieve the full task details using GetProspectingFromEngagementTask for per-engagement error information.

Exceptions

PartnerCentralSellingAPI.Client.exceptions.ThrottlingException
PartnerCentralSellingAPI.Client.exceptions.AccessDeniedException
PartnerCentralSellingAPI.Client.exceptions.InternalServerException
PartnerCentralSellingAPI.Client.exceptions.ValidationException