Tasks

Tasks Documentation

Task [LIST]

Task [LIST]

Request

Endpoint

GET /api/v2/tasks
Content-Type: application/vnd.api+json

Body

Parameters

Sorts

completed_at

Type Unknown

Description Sort by completed_at date

Required No

start_at

Type Unknown

Description Sort by start_at date

Required No

Filters

account_list_id

Type ID string

Description Filter by Account List; accepts an Account List id

Required No

activity_type

Type string

Description Filter by Action; Accepts multiple parameters, with values "Call", "Appointment", "Email", "Text Message", "Facebook Message", "Letter", "Newsletter", "Pre Call Letter", "Reminder Letter", "Support Letter", "Thank", "To Do", "Talk to In Person", or "Prayer Request"

Required No

any_tags

Type boolean

Description When filtering by tags this specifies if the filter should match tasks with any of the filtered tags if "true" or only tasks with all of the filtered tags if "false"

Required No

completed

Type boolean

Description Filter by Completed; Accepts values "true", or "false"

Required No

completed_at

Type string

Description Filter Tasks by completed at date given a date range

Required No

contact_appeal

Type string

Description Filter by Appeal; Accepts multiple parameters, with value 'no_appeals', or an appeal ID

Required No

contact_church

Type string

Description Filter by Church; Accepts multiple parameters, with value 'none', or a church name

Required No

contact_city

Type string

Description Filter by City; Accepts multiple parameters, with value 'none', or a city name

Required No

contact_country

Type string

Description Filter by Country; Accepts multiple parameters, with values 'none', or a country

Required No

contact_designation_account_id

Type string

Description Filter by Designation Account; accepts multiple parameters, separated by comma

Required No

contact_ids

Type [string]

Description Filter by Contact IDs; Accepts multiple parameters, with Contact IDs

Required No

contact_info_addr

Type string

Description Filter where contact has address; Accepts values 'Yes', or 'No'

Required No

contact_info_email

Type string

Description Filter where contact people have email addresses; Accepts values 'Yes', or 'No'

Required No

contact_info_mobile

Type string

Description Filter where contact people have mobile phones; Accepts values 'Yes', or 'No'

Required No

contact_info_phone

Type string

Description Filter where contact people have home phones; Accepts values 'Yes', or 'No'

Required No

contact_info_work_phone

Type string

Description Filter where contact people have work phones; Accepts values 'Yes', or 'No'

Required No

contact_likely

Type string

Description Filter by Likely To Give; Accepts multiple parameters, with values 'none', 'Least Likely', 'Likely', and 'Most Likely'

Required No

contact_metro_area

Type string

Description Filter by Metro Area; Accepts multiple parameters, with values 'none', or a metro area name

Required No

contact_newsletter

Type string

Description Filter by Newsletter Recipients; Accepts values 'none', 'all', 'address', 'email', and 'both'

Required No

contact_pledge_frequency

Type string

Description Filter by Pledge Frequency; Accepts multiple parameters, with numeric values like '0.23076923076923' (Weekly), '0.46153846153846' (Every 2 Weeks), '1.0' (Monthly), '2.0' (Every 2 Months), '3.0', '4.0', '6.0', '12.0' (Yearly), and '24.0' (Every 2 Years)

Required No

contact_referrer

Type string

Description Filter by Referrer; Accepts multiple parameters, with values 'none', 'any', or a Contact ID

Required No

contact_region

Type string

Description Filter by Region; Accepts multiple parameters, with values 'none', or a region name

Required No

contact_state

Type string

Description Filter by State; Accepts multiple parameters, with values 'none', or a state

Required No

contact_status

Type string

Description Filter by Status; Accepts multiple parameters, with values 'active', 'hidden', 'null', 'Never Contacted', 'Ask in Future', 'Cultivate Relationship', 'Contact for Appointment', 'Appointment Scheduled', 'Call for Decision', 'Partner - Financial', 'Partner - Special', 'Partner - Pray', 'Not Interested', 'Unresponsive', 'Never Ask', 'Research Abandoned', and 'Expired Referral'

Required No

contact_timezone

Type string

Description Filter by Timezone; Accepts multiple parameters

Required No

contact_type

Type string

Description Filter by Type; Accepts multiple parameters, with values 'person', and 'company'

Required No

created_at

Type Unknown

Description filter.created at

Required No

date_range

Type string

Description Filter by Date Range; Accepts values "last_month", "last_year", "last_two_years", "last_week", "overdue", "today", "tomorrow", "future", "upcoming" and "no_date"

Required No

exclude_tags

Type string

Description Filter tasks that have any of the tags included in this filter; comma separated value for multiple

Required No

ids

Type ID string

Description Filter tasks with ids included in this filter; comma separated value for multiple

Required No

next_action

Type string

Description Filter by Next Action; Accepts multiple parameters

Required No

overdue

Type boolean

Description Filter by overdue; Accepts values "true", or "false"

Required No

result

Type string

Description Filter by Result; Accepts multiple parameters

Required No

starred

Type boolean

Description Filter by starred; Accepts values "true", or "false"

Required No

start_at

Type string

Description Filter Tasks by start at date given a date range

Required No

tags

Type string

Description Filter by Tags; Accepts multiple parameters, with text values separated by comma

Required No

updated_at

Type date

Description Filter tasks that were updated in this date range

Required No

user_ids

Type ID string

Description Filter tasks with user_ids included in this filter; comma separated value for multiple

Required No

wildcard_search

Type string

Description Filter tasks where subject contains this filter

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": [
    {
      "id": "ac176d46-4dfe-4316-9863-fe0eb7005a59",
      "type": "tasks",
      "attributes": {
        "activity_type": "Call",
        "comments_count": 0,
        "completed": false,
        "completed_at": null,
        "created_at": "2022-01-12T17:18:32Z",
        "location": "MyString",
        "next_action": null,
        "notification_time_before": null,
        "notification_time_unit": null,
        "notification_type": null,
        "result": null,
        "starred": false,
        "start_at": "2012-03-08T14:59:46Z",
        "subject": "Call Keitha Torp",
        "subject_hidden": false,
        "tag_list": [

        ],
        "updated_at": "2022-01-12T17:18:32Z",
        "updated_in_db_at": "2022-01-12T17:18:32Z"
      },
      "relationships": {
        "user": {
          "data": null
        },
        "comments": {
          "data": [

          ]
        },
        "contacts": {
          "data": [

          ]
        },
        "people": {
          "data": [

          ]
        },
        "email_addresses": {
          "data": [

          ]
        },
        "phone_numbers": {
          "data": [

          ]
        },
        "activity_contacts": {
          "data": [

          ]
        },
        "account_list": {
          "data": {
            "id": "6acc2683-a75a-47bb-bdcf-05d42418a5b7",
            "type": "account_lists"
          }
        }
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_count": 1,
      "total_pages": 1
    },
    "sort": null,
    "filter": {
    }
  }
}

Fields

data

Type [Task]

Description An array of Task Objects

Task [POST]

Task [POST]

Request

Endpoint

POST /api/v2/tasks
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "tasks",
    "attributes": {
      "activity_type": "Call",
      "completed_at": null,
      "location": "MyString",
      "result": null,
      "starred": false,
      "start_at": "2012-03-08 14:59:46",
      "subject": "Call Young Bogisich",
      "updated_in_db_at": "2022-01-12 17:18:32 UTC"
    },
    "relationships": {
      "account_list": {
        "data": {
          "type": "account_lists",
          "id": "dbf5fffb-416d-4278-8e07-aa353df04226"
        }
      }
    }
  }
}

Parameters

Attributes

activity_type

Type string

Description The Task activity type

Required No

comments_count

Type integer

Description The number of Task comments

Required No

completed

Type boolean

Description Whether or not the Task has been completed

Required No

completed_at

Type string

Description Task completion time

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

location

Type string

Description The Task location

Required No

next_action

Type string

Description The next Task action

Required No

notification_time_before

Type integer

Description Notification time before

Required No

notification_time_unit

Type string

Description Unit of time for Task notification

Required No

notification_type

Type string

Description Type of notification set for Task

Required No

result

Type string

Description The result of the Task

Required No

starred

Type boolean

Description Whether or not the Task has been starred

Required No

start_at

Type string

Description Start at time for the Task

Required No

subject

Type string

Description The subject of the Task

Required No

subject_hidden

Type boolean

Description If the UI should hide the subject as it is automatically generated

Required No

tag_list

Type string

Description A list of tags associated with the Task

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

Relationships

account_list.data

Type Account List

Description The Account List that the Task belongs to

Required No

activity_contacts.data

Type [ActivityContact]

Description An array of ActivityContact references (this joins contacts to tasks)

Required No

user.data

Type User

Description The user assigned to this contact

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
201 Created

Body

{
  "data": {
    "id": "7dc5fef9-ee6d-4405-acea-39be9764adeb",
    "type": "tasks",
    "attributes": {
      "activity_type": "Call",
      "comments_count": 0,
      "completed": false,
      "completed_at": null,
      "created_at": "2022-01-12T17:18:32Z",
      "location": "MyString",
      "next_action": null,
      "notification_time_before": null,
      "notification_time_unit": null,
      "notification_type": null,
      "result": null,
      "starred": false,
      "start_at": "2012-03-08T01:59:46Z",
      "subject": "Call Young Bogisich",
      "subject_hidden": false,
      "tag_list": [

      ],
      "updated_at": "2022-01-12T17:18:32Z",
      "updated_in_db_at": "2022-01-12T17:18:32Z"
    },
    "relationships": {
      "user": {
        "data": null
      },
      "comments": {
        "data": [

        ]
      },
      "contacts": {
        "data": [

        ]
      },
      "people": {
        "data": [

        ]
      },
      "email_addresses": {
        "data": [

        ]
      },
      "phone_numbers": {
        "data": [

        ]
      },
      "activity_contacts": {
        "data": [

        ]
      },
      "account_list": {
        "data": {
          "id": "dbf5fffb-416d-4278-8e07-aa353df04226",
          "type": "account_lists"
        }
      }
    }
  }
}

Fields

Attributes

activity_type

Type string

Description The Task activity type

comments_count

Type integer

Description The number of Task comments

completed

Type boolean

Description Whether or not the Task has been completed

completed_at

Type string

Description Task completion time

created_at

Type date

Description The timestamp of when this resource was created

location

Type string

Description The Task location

next_action

Type string

Description The next Task action

notification_time_before

Type integer

Description Notification time before

notification_time_unit

Type string

Description Unit of time for Task notification

notification_type

Type string

Description Type of notification set for Task

result

Type string

Description The result of the Task

starred

Type boolean

Description Whether or not the Task has been starred

start_at

Type string

Description Start at time for the Task

subject

Type string

Description The subject of the Task

subject_hidden

Type boolean

Description If the UI should hide the subject as it is automatically generated

tag_list

Type string

Description A list of tags associated with the Task

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

account_list.data

Type Account List

Description The Account List that the Task belongs to

activity_contacts.data

Type [ActivityContact]

Description An array of ActivityContact references (this joins contacts to tasks)

comments.data

Type [Comment]

Description A list of comments associated to the Task

contacts.data

Type [Contact]

Description An array of Contact references for the Task

email_addresses.data

Type [Email Address]

Description A list of email addresses associated to the Task

people.data

Type [Person]

Description A list of people associated to the Task

phone_numbers.data

Type [Phone Number]

Description A list of phone numbers associated to the Task

user.data

Type User

Description The user assigned to this contact

Task [GET]

Task [GET]

Request

Endpoint

GET /api/v2/tasks/eaca7846-c9c7-4074-b2d2-48748300dbdf
Content-Type: application/vnd.api+json

Body

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "eaca7846-c9c7-4074-b2d2-48748300dbdf",
    "type": "tasks",
    "attributes": {
      "activity_type": "Call",
      "comments_count": 0,
      "completed": false,
      "completed_at": null,
      "created_at": "2022-01-12T17:18:32Z",
      "location": "MyString",
      "next_action": null,
      "notification_time_before": null,
      "notification_time_unit": null,
      "notification_type": null,
      "result": null,
      "starred": false,
      "start_at": "2012-03-08T14:59:46Z",
      "subject": "Call Jarred Lind",
      "subject_hidden": false,
      "tag_list": [

      ],
      "updated_at": "2022-01-12T17:18:32Z",
      "updated_in_db_at": "2022-01-12T17:18:32Z"
    },
    "relationships": {
      "user": {
        "data": null
      },
      "comments": {
        "data": [

        ]
      },
      "contacts": {
        "data": [

        ]
      },
      "people": {
        "data": [

        ]
      },
      "email_addresses": {
        "data": [

        ]
      },
      "phone_numbers": {
        "data": [

        ]
      },
      "activity_contacts": {
        "data": [

        ]
      },
      "account_list": {
        "data": {
          "id": "1a5c94e4-2447-476c-a727-cf67c3f6b0b3",
          "type": "account_lists"
        }
      }
    }
  }
}

Fields

Attributes

activity_type

Type string

Description The Task activity type

comments_count

Type integer

Description The number of Task comments

completed

Type boolean

Description Whether or not the Task has been completed

completed_at

Type string

Description Task completion time

created_at

Type date

Description The timestamp of when this resource was created

location

Type string

Description The Task location

next_action

Type string

Description The next Task action

notification_time_before

Type integer

Description Notification time before

notification_time_unit

Type string

Description Unit of time for Task notification

notification_type

Type string

Description Type of notification set for Task

result

Type string

Description The result of the Task

starred

Type boolean

Description Whether or not the Task has been starred

start_at

Type string

Description Start at time for the Task

subject

Type string

Description The subject of the Task

subject_hidden

Type boolean

Description If the UI should hide the subject as it is automatically generated

tag_list

Type string

Description A list of tags associated with the Task

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

account_list.data

Type Account List

Description The Account List that the Task belongs to

activity_contacts.data

Type [ActivityContact]

Description An array of ActivityContact references (this joins contacts to tasks)

comments.data

Type [Comment]

Description A list of comments associated to the Task

contacts.data

Type [Contact]

Description An array of Contact references for the Task

email_addresses.data

Type [Email Address]

Description A list of email addresses associated to the Task

people.data

Type [Person]

Description A list of people associated to the Task

phone_numbers.data

Type [Phone Number]

Description A list of phone numbers associated to the Task

user.data

Type User

Description The user assigned to this contact

Task [PUT]

Task [PUT]

Request

Endpoint

PUT /api/v2/tasks/91f570a3-67e6-4b5d-89fc-1c3ab4ae16c4
Content-Type: application/vnd.api+json

Body

{
  "data": {
    "type": "tasks",
    "attributes": {
      "activity_type": "Call",
      "completed_at": null,
      "location": "MyString",
      "result": null,
      "starred": false,
      "start_at": "2012-03-08 14:59:46",
      "subject": "Call Ellan Cole",
      "updated_in_db_at": "2022-01-12 17:18:32 UTC"
    },
    "relationships": {
      "account_list": {
        "data": {
          "type": "account_lists",
          "id": "6658a94c-4a15-42f8-bff0-a3e194fc9087"
        }
      }
    }
  }
}

Parameters

Attributes

activity_type

Type string

Description The Task activity type

Required No

comments_count

Type integer

Description The number of Task comments

Required No

completed

Type boolean

Description Whether or not the Task has been completed

Required No

completed_at

Type string

Description Task completion time

Required No

created_at

Type date

Description The timestamp of when this resource was created

Required No

location

Type string

Description The Task location

Required No

next_action

Type string

Description The next Task action

Required No

notification_time_before

Type integer

Description Notification time before

Required No

notification_time_unit

Type string

Description Unit of time for Task notification

Required No

notification_type

Type string

Description Type of notification set for Task

Required No

overwrite

Type boolean

Description Only used for updating a record where you want to ignore the server's ' 'updated_in_db_at value and force overwrite the values for the record. ' 'Must be true to work.

Required No

result

Type string

Description The result of the Task

Required No

starred

Type boolean

Description Whether or not the Task has been starred

Required No

start_at

Type string

Description Start at time for the Task

Required No

subject

Type string

Description The subject of the Task

Required No

subject_hidden

Type boolean

Description If the UI should hide the subject as it is automatically generated

Required No

tag_list

Type string

Description A list of tags associated with the Task

Required No

updated_at

Type date

Description The timestamp of when this resource was last updated

Required No

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Required No

Relationships

account_list.data

Type Account List

Description The Account List that the Task belongs to

Required No

activity_contacts.data

Type [ActivityContact]

Description An array of ActivityContact references (this joins contacts to tasks)

Required No

user.data

Type User

Description The user assigned to this contact

Required No

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

{
  "data": {
    "id": "91f570a3-67e6-4b5d-89fc-1c3ab4ae16c4",
    "type": "tasks",
    "attributes": {
      "activity_type": "Call",
      "comments_count": 0,
      "completed": false,
      "completed_at": null,
      "created_at": "2022-01-12T17:18:32Z",
      "location": "MyString",
      "next_action": null,
      "notification_time_before": null,
      "notification_time_unit": null,
      "notification_type": null,
      "result": null,
      "starred": false,
      "start_at": "2012-03-08T01:59:46Z",
      "subject": "Call Ellan Cole",
      "subject_hidden": false,
      "tag_list": [

      ],
      "updated_at": "2022-01-12T17:18:32Z",
      "updated_in_db_at": "2022-01-12T17:18:32Z"
    },
    "relationships": {
      "user": {
        "data": null
      },
      "comments": {
        "data": [

        ]
      },
      "contacts": {
        "data": [

        ]
      },
      "people": {
        "data": [

        ]
      },
      "email_addresses": {
        "data": [

        ]
      },
      "phone_numbers": {
        "data": [

        ]
      },
      "activity_contacts": {
        "data": [

        ]
      },
      "account_list": {
        "data": {
          "id": "6658a94c-4a15-42f8-bff0-a3e194fc9087",
          "type": "account_lists"
        }
      }
    }
  }
}

Fields

Attributes

activity_type

Type string

Description The Task activity type

comments_count

Type integer

Description The number of Task comments

completed

Type boolean

Description Whether or not the Task has been completed

completed_at

Type string

Description Task completion time

created_at

Type date

Description The timestamp of when this resource was created

location

Type string

Description The Task location

next_action

Type string

Description The next Task action

notification_time_before

Type integer

Description Notification time before

notification_time_unit

Type string

Description Unit of time for Task notification

notification_type

Type string

Description Type of notification set for Task

result

Type string

Description The result of the Task

starred

Type boolean

Description Whether or not the Task has been starred

start_at

Type string

Description Start at time for the Task

subject

Type string

Description The subject of the Task

subject_hidden

Type boolean

Description If the UI should hide the subject as it is automatically generated

tag_list

Type string

Description A list of tags associated with the Task

updated_at

Type date

Description The timestamp of when this resource was last updated

updated_in_db_at

Type date

Description This is to be used as a reference for the last time the resource was updated in the remote database - specifically for when data is updated while the client is offline.

Relationships

account_list.data

Type Account List

Description The Account List that the Task belongs to

activity_contacts.data

Type [ActivityContact]

Description An array of ActivityContact references (this joins contacts to tasks)

comments.data

Type [Comment]

Description A list of comments associated to the Task

contacts.data

Type [Contact]

Description An array of Contact references for the Task

email_addresses.data

Type [Email Address]

Description A list of email addresses associated to the Task

people.data

Type [Person]

Description A list of people associated to the Task

phone_numbers.data

Type [Phone Number]

Description A list of phone numbers associated to the Task

user.data

Type User

Description The user assigned to this contact

Task [DELETE]

Task [DELETE]

Request

Endpoint

DELETE /api/v2/tasks/c9e34971-ea6a-464f-9adf-6c3a85219450
Content-Type: application/vnd.api+json

Body

Response

Headers

204 No Content

Body

Tasks [BULK DELETE]

Tasks [BULK DELETE]

Request

Endpoint

DELETE /api/v2/tasks/bulk
Content-Type: application/vnd.api+json

Body

{
  "data": [
    {
      "data": {
        "type": "tasks",
        "id": "5156e3ec-a248-4d54-bc6f-adaafc90ea72"
      }
    },
    {
      "data": {
        "type": "tasks",
        "id": "6c6e5c77-6681-49b9-a42f-79d5df6de1e8"
      }
    }
  ]
}

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

[
  {
    "data": {
      "id": "6c6e5c77-6681-49b9-a42f-79d5df6de1e8",
      "type": "tasks",
      "attributes": {
        "activity_type": "Call",
        "comments_count": 0,
        "completed": false,
        "completed_at": null,
        "created_at": "2022-01-12T17:18:21Z",
        "location": "MyString",
        "next_action": null,
        "notification_time_before": null,
        "notification_time_unit": null,
        "notification_type": null,
        "result": null,
        "starred": false,
        "start_at": "2012-03-08T14:59:46Z",
        "subject": "Call Louella Hahn Sr.",
        "subject_hidden": false,
        "tag_list": [

        ],
        "updated_at": "2022-01-12T17:18:21Z",
        "updated_in_db_at": "2022-01-12T17:18:21Z"
      },
      "relationships": {
        "user": {
          "data": null
        },
        "comments": {
          "data": [

          ]
        },
        "contacts": {
          "data": [

          ]
        },
        "people": {
          "data": [

          ]
        },
        "email_addresses": {
          "data": [

          ]
        },
        "phone_numbers": {
          "data": [

          ]
        },
        "activity_contacts": {
          "data": [

          ]
        },
        "account_list": {
          "data": {
            "id": "2f871b66-126c-4361-9c12-f12c6f6195d5",
            "type": "account_lists"
          }
        }
      }
    }
  },
  {
    "data": {
      "id": "5156e3ec-a248-4d54-bc6f-adaafc90ea72",
      "type": "tasks",
      "attributes": {
        "activity_type": "Call",
        "comments_count": 0,
        "completed": false,
        "completed_at": null,
        "created_at": "2022-01-12T17:18:21Z",
        "location": "MyString",
        "next_action": null,
        "notification_time_before": null,
        "notification_time_unit": null,
        "notification_type": null,
        "result": null,
        "starred": false,
        "start_at": "2012-03-08T14:59:46Z",
        "subject": "Call Corene D'Amore",
        "subject_hidden": false,
        "tag_list": [

        ],
        "updated_at": "2022-01-12T17:18:21Z",
        "updated_in_db_at": "2022-01-12T17:18:21Z"
      },
      "relationships": {
        "user": {
          "data": null
        },
        "comments": {
          "data": [

          ]
        },
        "contacts": {
          "data": [

          ]
        },
        "people": {
          "data": [

          ]
        },
        "email_addresses": {
          "data": [

          ]
        },
        "phone_numbers": {
          "data": [

          ]
        },
        "activity_contacts": {
          "data": [

          ]
        },
        "account_list": {
          "data": {
            "id": "2f871b66-126c-4361-9c12-f12c6f6195d5",
            "type": "account_lists"
          }
        }
      }
    }
  }
]

Fields

data

Type [Task]

Description An array of Tasks that have just been deleted

Tasks [BULK POST]

Tasks [BULK POST]

Request

Endpoint

POST /api/v2/tasks/bulk
Content-Type: application/vnd.api+json

Body

{
  "data": [
    {
      "data": {
        "type": "tasks",
        "id": "f28e7a87-ad86-4de9-9890-aa92bba7f3bb",
        "attributes": {
          "starred": false,
          "location": "MyString",
          "subject": "Call Sal Mann",
          "start_at": "2012-03-08 14:59:46",
          "activity_type": "Call",
          "result": null,
          "completed_at": null,
          "updated_in_db_at": "2022-01-12 17:18:21 UTC"
        },
        "relationships": {
          "account_list": {
            "data": {
              "id": "65963674-4811-41f6-ba83-69cb2c1afeae",
              "type": "account_lists"
            }
          }
        }
      }
    }
  ]
}

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

[
  {
    "data": {
      "id": "f28e7a87-ad86-4de9-9890-aa92bba7f3bb",
      "type": "tasks",
      "attributes": {
        "activity_type": "Call",
        "comments_count": 0,
        "completed": false,
        "completed_at": null,
        "created_at": "2022-01-12T17:18:21Z",
        "location": "MyString",
        "next_action": null,
        "notification_time_before": null,
        "notification_time_unit": null,
        "notification_type": null,
        "result": null,
        "starred": false,
        "start_at": "2012-03-08T01:59:46Z",
        "subject": "Call Sal Mann",
        "subject_hidden": false,
        "tag_list": [

        ],
        "updated_at": "2022-01-12T17:18:21Z",
        "updated_in_db_at": "2022-01-12T17:18:21Z"
      },
      "relationships": {
        "user": {
          "data": null
        },
        "comments": {
          "data": [

          ]
        },
        "contacts": {
          "data": [

          ]
        },
        "people": {
          "data": [

          ]
        },
        "email_addresses": {
          "data": [

          ]
        },
        "phone_numbers": {
          "data": [

          ]
        },
        "activity_contacts": {
          "data": [

          ]
        },
        "account_list": {
          "data": {
            "id": "65963674-4811-41f6-ba83-69cb2c1afeae",
            "type": "account_lists"
          }
        }
      }
    }
  }
]

Fields

data

Type [Task / error]

Description List of Task objects that have been successfully updated and list of errors related to Task objects that were not updated successfully

Tasks [BULK PUT]

Tasks [BULK PUT]

Request

Endpoint

PUT /api/v2/tasks/bulk
Content-Type: application/vnd.api+json

Body

{
  "data": [
    {
      "data": {
        "type": "tasks",
        "id": "eb96b49e-3bde-4e12-8c99-2da73764a9c1",
        "attributes": {
          "starred": false,
          "location": "MyString",
          "subject": "Call Miss Arline Waters",
          "start_at": "2012-03-08 14:59:46",
          "activity_type": "Call",
          "result": null,
          "completed_at": null,
          "updated_in_db_at": "2022-01-12 17:18:21 UTC"
        }
      }
    }
  ]
}

Response

Headers

Content-Type: application/vnd.api+json; charset=utf-8
200 OK

Body

[
  {
    "data": {
      "id": "eb96b49e-3bde-4e12-8c99-2da73764a9c1",
      "type": "tasks",
      "attributes": {
        "activity_type": "Call",
        "comments_count": 0,
        "completed": false,
        "completed_at": null,
        "created_at": "2022-01-12T17:18:21Z",
        "location": "MyString",
        "next_action": null,
        "notification_time_before": null,
        "notification_time_unit": null,
        "notification_type": null,
        "result": null,
        "starred": false,
        "start_at": "2012-03-08T01:59:46Z",
        "subject": "Call Miss Arline Waters",
        "subject_hidden": false,
        "tag_list": [

        ],
        "updated_at": "2022-01-12T17:18:21Z",
        "updated_in_db_at": "2022-01-12T17:18:21Z"
      },
      "relationships": {
        "user": {
          "data": null
        },
        "comments": {
          "data": [

          ]
        },
        "contacts": {
          "data": [

          ]
        },
        "people": {
          "data": [

          ]
        },
        "email_addresses": {
          "data": [

          ]
        },
        "phone_numbers": {
          "data": [

          ]
        },
        "activity_contacts": {
          "data": [

          ]
        },
        "account_list": {
          "data": {
            "id": "d306eb29-59c6-4b46-9ccb-ba47be7cfcc1",
            "type": "account_lists"
          }
        }
      }
    }
  }
]

Fields

data

Type [Task / error]

Description Array of both Task objects that have been successfully updated and of errors related to Contact objects that were not updated successfully