Link Ticketing Project | Taktoria API

{
  "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"
  }
}

Have a launch follow its work in a ticketing system, by its address, replacing anything it followed, as pasting it on the launch’s page does: a Linear project, a Jira epic or issue, a GitHub organization’s project or a repository’s milestone, an Asana project, or a ClickUp list or task. One in a system connected to the workspace must be one the connection can see (in its Linear workspace, on one of its Jira sites, in the GitHub organization the app is installed on, or in its Asana or ClickUp workspaces), and syncs at once: the answer’s ticketingProject says how that went. Any other address, a whole Jira project, a GitHub repository, or a ClickUp folder or space included, is kept as a link and does not sync. It reads the system, so it shares the ticketing-sync budget with a sync. 404 not_found when the connection cannot find or see the project, 409 conflict for one in another workspace or site of the system than the one connected, 409 ticketing_reconnect when the system turned the connection down (a workspace admin connects it again in Settings → Integrations), and 502 upstream_error when it did not answer. Needs launches:write.

Authentication

AuthorizationBearer

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

Path parameters

launchIdstringRequired

Request

This endpoint expects an object.

urlstringRequired

Its address, as copied from the browser: a Linear project (https://linear.app/acme/project/checkout-v2-1a2b3c), a Jira epic or issue (https://acme.atlassian.net/browse/CHK-12, or a board with it open), a GitHub organization’s project (https://github.com/orgs/acme/projects/12) or a repository’s milestone (https://github.com/acme/web/milestone/3), an Asana project (https://app.asana.com/1/<workspace>/project/<project>), or a ClickUp list (https://app.clickup.com/<workspace>/v/li/<list>) or task (https://app.clickup.com/t/<task>). Anything else, a ClickUp folder or space included, is kept as a link.

Response

This endpoint returns an object.

idstring

organizationIdstring

namestring

statusenum

Where a launch sits in its lifecycle.

ownerslist of objects

Everybody who owns the launch. They hear about its decisions.

teamslist of objects

The teams the launch belongs to.

draftboolean

Held back until published: nobody has been told about it, its steps are in no review queue, and it cannot be launched. A draft is never LAUNCHED: launching it, adding one as a draft with that status, or setting status to LAUNCHED on it is a 409 draft, unless the same request publishes it with draft: false.

stepsGeneratedboolean

stakeholderslist of objects

stepCountinteger

percentToLaunchinteger

Share of steps that have been approved, excepted or marked N/A.

createdAtdatetime

updatedAtdatetime

descriptionstringOptional

keyCustomersstringOptional

The customers this launch is for, or who asked for it. Free text.

pmobjectOptional

The first of owners, from when a launch had one. Read owners.

pmUserIdstringOptional

The first owner’s id. Read owners.

orgTeamobjectOptional

The first of teams, from when a launch had one. Read teams.

plannedLaunchDatedatetimeOptional

actualLaunchDatedatetimeOptional

healthenumOptional

As its newest update says; null until somebody posts one, and once the launch has launched. See /launches/{launchId}/posts.

Allowed values:

launchTemplateIdstringOptional

The launch template its steps come from. See /launch-templates.

launchTemplateobjectOptional

That template's id and name.

ticketingProjectobjectOptional

The ticketing project it follows, if somebody linked one. See /launches/{launchId}/ticketing-project.

Errors

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Validation Error

429

Too Many Requests Error

429

Too Many Requests Error

502

Upstream Error