Podio API Documentation
Tasks: Create task
Creates a new task.
Usage
- PHP Client
-
PodioTask.php
PodioTask::create( $attributes = array(), $options = array() ); - Ruby Gem
-
task.rb
Podio::Task.create( attributes, options = {} )
Parameters
- hook
True if hooks should be executed for the change, false otherwise.
Default value: true- silent
If set to true, the object will not be bumped up in the stream and notifications will not be generated.
Default value: false
Request
{
"text": The text of the task,
"description": The description of the task (optional),
"private": True if the task should be private, false otherwise,
"due_date": The due date of the task, if any (in local time),
"due_time": The due time of the task, if any (in local time),
"due_on": The due date and time of the task, if any (in UTC),
"ref_type": Optional ref type to which the task is attached to
"ref_id": Optional ref id to which the task is attached to,
"responsible": The contact(s) responsible for the task, identified by either:
An integer (user_id)
A {"type": contact identifier type, "id": contact identifier value} object
A list of integers and/or contact identifier objects
(with 5 supported contact identifier types: "user", "profile", "mail", "space", "external"),
"file_ids": The list of files to attach to this task,
[
"{file_id}",
... (more files)
],
"labels": The list of labels in text form
[
"{label}",
... (more labels)
],
"label_ids": The list labels in id form
[
"{label_id}",
... (more labels)
],
"reminder": Optional reminder on this task
{
"remind_delta": Minutes (integer) to remind before the due date
},
"recurrence": The recurrence for the task, if any,
{
"name": The name of the recurrence, "weekly", "monthly" or "yearly",
"config": The configuration for the recurrence, depends on the type
{
"days": List of weekdays ("monday", "tuesday", etc) (for "weekly"),
"repeat_on": When to repeat, "day_of_week" or "day_of_month" (for "monthly")
},
"step": The step size, 1 or more,
"until": The latest date the recurrence should take place
},
"external_id": Any external id for the task, if from another system
}
Response
{
"task_id": The id of the newly created task,
... (more properties, see the get task operation)
}