USusepylon
import

Migration only: Import a project

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 /projects instead.

Imports a project with its original timestamps. Unlike POST /projects, this does not fire triggers, notifications, realtime updates, or analytics, and it accepts created_at and updated_at.

Rate limit: 120 requests per minute

post/import/projects

Request

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

Request body

account_idstring required

The ID of the account this project belongs to.

created_atstring date-time

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

customer_portal_visibleboolean

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

description_htmlstring

Description HTML for this project.

end_datestring date-time

End date for this project, in RFC 3339 format.

namestring required

The name of the project.

owner_idstring

The ID of the user who owns this project.

start_datestring date-time

Start date for this project, in RFC 3339 format.

statusstring

The status of the project. One of not_started, in_progress, or completed. Defaults to not_started.

updated_atstring date-time

The time the project 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": {
      "health": {
        "value": "on_track"
      }
    }
  }
}

Changes