Skip to main content

​
Overview

Represents an account-level task such as profile updates or warmup activities.

​
Fields

FieldTypeDescription
idstringUnique task identifier
account_idstringID of the account this task belongs to
typeTaskTypeTask type (see task types below)
statusstringCurrent status: 'scheduled', 'pending', 'complete', or 'failed'
scheduled_timestring | nullISO 8601 timestamp when task should execute
durationnumber | nullTask duration in seconds (for warmup tasks)
keywordsstring | nullKeywords for search tasks (text string)
edit_profile_infoobject | nullProfile update details (for edit_profile tasks)
created_atstringISO 8601 timestamp when task was created

​
Task Types

TypeDescription
warmup_scrollAccount scrolling activity to maintain authenticity
warmup_search_termSearch for specific terms
warmup_search_profileSearch for profiles
edit_profileUpdate profile (nickname, avatar, bio)
update_postsRefresh post data

​
Task Status Values

StatusDescription
scheduledTask is scheduled to run at a future time
pendingTask is currently being executed
completeTask completed successfully
failedTask failed to execute

​
Edit Profile Info

For edit_profile tasks, the edit_profile_info object may contain:
FieldTypeDescription
avatarUrlstringNew avatar/profile picture URL
nickNamestringNew display name
biostringNew bio text

​
Example Response

{
  "id": "task_abc123",
  "account_id": "acc_123456",
  "type": "edit_profile",
  "status": "scheduled",
  "scheduled_time": "2024-12-31T12:00:00Z",
  "duration": null,
  "keywords": null,
  "edit_profile_info": {
    "nickName": "New Display Name",
    "bio": "Updated bio text"
  },
  "created_at": "2024-12-25T10:00:00Z"
}