Task and Status Identifiers

Task identifiers

The identifier parameter is used to filter on task type. A list of task identifiers which can be used for the task list and task info API endpoints can be found below.

Many of the tasks are manually initiated. API initiated tasks or automated tasks are those more likely to require API based checks.

Task Identifier	Description
`profile_import`	Asynchronous task to import profiles
`profile_export_data`	Asynchronous task to export profiles
`profile_delete_personal_data`	Asynchronous task to delete all PII data from a profile
`cleanup_users`	Asynchronous task to delete all profiles which should no longer be held according to the configured data retention policy
`list_import`	Asynchronous task to import a target audience from a list of users
`list_export`	Asynchronous task to export a target audience of a list of users
`message_export_campaign`	Asynchronous task to export campaign data
`message_export_send`	Asynchronous task to export message send data
`campaign_count_recipients`	Asynchronous task to count the target audience of a campaign (or eligible recipients)
`campaign_preview_recipients`	Asynchronous task to preview the target audience of a campaign (or eligible recipients)
`segment_count_recipients`	Asynchronous task to count the target audience of a segment (or eligible recipients)
`segment_export_devices`	Asynchronous task to export the target audience of a segment (or eligible recipients) as a list of device IDs
`segment_export_profiles`	Asynchronous task to export the target audience of a segment (or eligible recipients) as a list of user IDs
`active_directory_lists_sync`	Example of an asynchronous task related to an integration—syncing a list from active directory
`active_directory_profiles_sync`	Example of an asynchronous task related to an integration—syncing profiles from active directory
`kochava_sync_installs`	Example of an asynchronous task related to an integration—syncing attributed installs from Kochava

Return the list of profile import tasks after a specific time order the list descending by ID:

curl --request POST \
  --url https://external-api.xtremepush.com/api/external/list/task \
  --header 'content-type: application/json' \
  --data '{
    "apptoken": "YOUR_APPTOKEN",
    "condition": [
      ["identifier", "=" , "profile_import"],
      ["finish_time", ">" , 1580226128]
    ],
    "order": ["id DESC"],
    "select": ["id", "identifier", "errors", "finish_time"]
}'

Sample response:

{
    "success": true,
    "code": 200,
    "data": [
        {
            "id": 5853,
            "identifier": "profile_import",
            "errors": {
                "file[columns]": [
                    "Column 'firstname' is not set to be a profile attribute"
                ],
                "file[rows]": [
                    "Rows must contain identifier (Row 4)"
                ]
            },
            "finish_time": 1596217813
        },
        {
            "id": 5852,
            "identifier": "profile_import",
            "errors": {
                "file[columns]": [
                    "Column 'first.name' is not a recognized user profile field or attribute",
                    "Column 'LTV' is not a recognized user profile field or attribute"
                ]
            },
            "finish_time": 1596216946
        },
        {
            "id": 62,
            "identifier": "profile_import",
            "errors": {
                "file[rows]": [
                    "7 Rows must contain identifier ( Row 6, Row 11, Row 13, Row 18, ...)",
                    "9 Rows are duplicates ( Row 12, Row 14, Row 15, Row 19, ...)"
                ]
            },
            "finish_time": 1580228176
        }
    ]
}

Status identifiers

Task status types are displayed by their identifier:

Status ID	Status name
0	New
1	Executing
2	Done
3	Error
4	Fatal

Documentation Index

Task and Status Identifiers

Task identifiers

Status identifiers