Create | Taktoria API

{
  "id": "id",
  "organizationId": "organizationId",
  "name": "name",
  "status": "SCOPING",
  "capitalized": 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",
  "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",
  "weeklyUpdate": "weeklyUpdate"
}

Add a launch. Pass generateSteps: true to immediately copy the launch step template onto it, which is what fills each reviewer’s queue.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

namestringRequired

descriptionstringOptional

statusenumOptional

Where a launch sits in its lifecycle.

pmUserIdstringOptional

orgTeamIdstringOptional

plannedLaunchDatestringOptional

actualLaunchDatestringOptional

weeklyUpdatestringOptional

stakeholderUserIdslist of stringsOptional

generateStepsbooleanOptional

Generate the step checklist from the org's launch step template.

Response

This endpoint returns an object.

idstring

organizationIdstring

namestring

statusenum

Where a launch sits in its lifecycle.

capitalizedboolean

Whether Finance has capitalized this launch.

stepsGeneratedboolean

stakeholderslist of objects

stepCountinteger

percentToLaunchinteger

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

createdAtdatetime

updatedAtdatetime

descriptionstringOptional

pmobjectOptional

The product manager accountable for the launch.

pmUserIdstringOptional

orgTeamobjectOptional

An organizational team such as Eagles or Ravens.

plannedLaunchDatedatetimeOptional

actualLaunchDatedatetimeOptional

weeklyUpdatestringOptional

The short status line stakeholders read each week.

Errors

401

Unauthorized Error

402

Subscription Required Error

422

Validation Error