Bulk create tasks

post

https://app2.gettruss.io/api/v1/projects/{project_id}/tasks/bulk_create

Bulk-creates up to 100 tasks inside a project. Pass exactly one of bulk_tasks or checklist_template_id. The request is all-or-nothing - if any task is invalid, no tasks are created and the response includes the failing array indices.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

project_id

integer

required

ID of the project to create tasks for.

Body Params

bulk_tasks

array of objects

required

length between 1 and 100

bulk_tasks*

Same fields as Create task. name is required except on contact_info_verification and ez_sign tasks, where it must be omitted.

name

string

Name of the task

description

string

Description of the task - supports limited subset of HTML <b>, <ul>, <li>, <br>, and <a>.

due_date

date-time | null

When the task is due (ISO 8601). Optional.

document_category_id

integer | null

Document type to file the task under - see GET /document_categories.

task_type

string

enum

Omit for a plain task. See Task types. Set per row, so one request can mix types.

Allowed:

amount_due

string

^\d+(\.\d{1,2})?$

Invoice tasks only, and required for them. Amount the client owes in dollars, as a plain decimal string with at most two decimal places - e.g. "1250.00". Must be greater than 0 and no more than 99999.

verification_types

array of strings

length ≥ 1

contact_info_verification tasks only, and required for them.

verification_types

Allowed:

ez_sign_template_id

integer

ez_sign tasks only, and required for them.

all_must_sign

boolean

ez_sign tasks only. Defaults to the template's setting.

checklist_template_id

integer

ID of a checklist template belonging to the firm. Every task in the template will be created in template order, including the types bulk_tasks cannot create - questionnaires and worksheets.

Responses

404

checklist_template_id does not belong to the firm or does not exist.

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200successfully creates the tasks.

400The request does not contain exactly one supported input, bulk_tasks is not a non-empty array, or the request would create more than 100 tasks.

422one or more tasks failed validation; no tasks were created.