USusepylon
import

Migration only: Import a task

Changed on

Migration only. This endpoint brings historical data into Pylon from another system and isn't meant for everyday writes. To create records as part of normal use, call POST /tasks instead.

Imports a task with its original timestamps. Unlike POST /tasks, this does not fire triggers, notifications, realtime updates, or analytics, and it accepts created_at, updated_at, started_at and completed_at. Import projects before the tasks that belong to them.

Rate limit: 120 requests per minute

post/import/tasks

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/import/tasks
  • Auth
    HTTP bearer

Request body

account_idstring

Account ID for this task.

assignee_idstring

Assignee ID for this task. May be a user or a contact.

body_htmlstring

Body HTML for this task.

completed_atstring date-time

The time the task was completed, in RFC 3339 format. Must be empty when status is not started.

created_atstring date-time

The time the task was created in the system it is being imported from, in RFC 3339 format. Defaults to now.

customer_portal_visibleboolean

Whether the task is visible in the customer portal. Defaults to false.

due_datestring date-time

Due date for this task, in RFC 3339 format.

milestone_idstring

Milestone ID for this task.

parent_task_idstring

Parent task ID, to import this task as a subtask.

project_idstring

Project ID for this task.

started_atstring date-time

The time work started on the task, in RFC 3339 format. Must be empty when status is not started.

statusstring

Status for this task. Accepts the default statuses or a custom status slug. Defaults to not_started.

titlestring required

Title for this task.

updated_atstring date-time

The time the task was last updated in the system it is being imported from, in RFC 3339 format. Defaults to now.

Response

request_idstring required

The request ID for tracking.

Example response

{
  "data": {
    "custom_fields": {
      "priority": {
        "value": "high"
      }
    }
  }
}

Changes

  • 05e40342a893Revision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

  • 554844ef05a1Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status