Sync Ticketing Project

POST

/launches/:launchId/ticketing-project/sync

POST

/api/v1/launches/:launchId/ticketing-project/sync

curl -X POST https://api.taktoria.com/api/v1/launches/launchId/ticketing-project/sync \
     -H "Authorization: Bearer <token>"

{
  "statusChanged": true,
  "updatesAdded": 1,
  "completed": true,
  "launch": {
    "id": "id",
    "organizationId": "organizationId",
    "name": "name",
    "status": "SCOPING",
    "owners": [
      {
        "id": "id",
        "name": "name",
        "email": "email",
        "image": "image"
      },
      {
        "id": "id",
        "name": "name",
        "email": "email",
        "image": "image"
      }
    ],
    "teams": [
      {
        "id": "id",
        "name": "name"
      },
      {
        "id": "id",
        "name": "name"
      }
    ],
    "draft": true,
    "stepsGenerated": true,
    "stakeholders": [
      {
        "id": "id",
        "name": "name",
        "email": "email",
        "image": "image"
      },
      {
        "id": "id",
        "name": "name",
        "email": "email",
        "image": "image"
      }
    ],
    "stepCount": 1,
    "percentToLaunch": 1,
    "createdAt": "2024-01-15T09:30:00Z",
    "updatedAt": "2024-01-15T09:30:00Z",
    "description": "description",
    "keyCustomers": "keyCustomers",
    "pm": {
      "id": "id",
      "name": "name",
      "email": "email",
      "image": "image"
    },
    "pmUserId": "pmUserId",
    "orgTeam": {
      "id": "id",
      "name": "name"
    },
    "plannedLaunchDate": "2024-01-15T09:30:00Z",
    "actualLaunchDate": "2024-01-15T09:30:00Z",
    "health": "ON_TRACK",
    "launchTemplateId": "launchTemplateId",
    "launchTemplate": {
      "id": "id",
      "name": "name"
    },
    "ticketingProject": {
      "name": "name",
      "url": "url",
      "system": "LINEAR",
      "statusName": "statusName",
      "statusKind": "BACKLOG",
      "progress": 1.1,
      "completedAt": "2024-01-15T09:30:00Z",
      "syncedAt": "2024-01-15T09:30:00Z",
      "syncError": "syncError"
    }
  }
}

Sync now, as the daily sync does, for this launch: its status, progress, and new status updates (Linear, GitHub projects) or comments (Jira, ClickUp); an Asana project brings its completion and progress, not its status updates. 404 not_found when the launch follows nothing; 409 conflict for a link that cannot sync (a whole Jira project, a GitHub repository, a ClickUp folder or space, or a system Taktoria does not sync); 409 ticketing_not_connected or 409 ticketing_reconnect when a workspace admin must connect its system in Settings → Integrations. Needs launches:write.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

launchIdstringRequired

Response

This endpoint returns an object.

statusChangedboolean

Whether the project's status moved the launch's.

updatesAddedinteger

How many of the project’s status updates (Linear, GitHub projects) or comments (Jira, ClickUp) became the launch’s. Always 0 for an Asana project, whose status updates Taktoria’s connection cannot read.

completedboolean

Whether this sync found the project newly done, flagging the launch ready to launch.

launchobject

A product launch tracked on the calendar.

Errors

403

Forbidden Error

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error

429

Too Many Requests Error

502

Upstream Error