> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.taktoria.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.taktoria.com/_mcp/server. # Get GET https://api.taktoria.com/api/v1/launch-overview What LaunchCal's Overview page shows: launches in flight, steps due this week, the reviews awaiting you, and how many launched this quarter, the workspace's fiscal quarter (its year starts in the month set under Settings → General, so Q1 may begin in April). With the next launches coming up. Needs `launches:read`. For a period of your choosing, see `GET /launch-analytics`. Reference: https://docs.taktoria.com/api-reference/launch-overview/get ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Servers - `https://api.taktoria.com/api/v1` (Production, default) - `http://localhost:3000/api/v1` (Local) ## Response ### 200 - `quarter` (OverviewQuarter, required) — The workspace's current fiscal quarter, which "this quarter" means. - `inFlight` (integer, required) — Published launches that have neither launched nor been put on hold. - `dueThisWeek` (integer, required) — Steps not started or in review, due within the next seven days or overdue, on launches in flight. - `awaitingYou` (integer, required) — Your own steps not started or in review, on published launches that have not launched: a session's person's, or an API key's maker's. Always 0 for a key whose maker has left the workspace. - `launchedThisQuarter` (integer, required) — Launches that launched in `quarter`, by their actual launch date. - `upcoming` (list of Launch, required) — The next six launches in flight, by planned launch date, from today. ## Errors ### 401 Unauthorized Error - `error` (ErrorDetail, required) ### 402 Subscription Required Error The organization has no subscription for the app that lets it in: active, trialing or past due. One that is unpaid (Stripe stopped retrying a failed payment), paused, incomplete or cancelled answers this too, and the message says which: an unpaid app is locked until a workspace admin updates the payment details. `details.status` is the app's subscription status (null with none), and `details.paymentIssue` is `unpaid`, or `payment_failed` for an incomplete one whose first payment failed, as `paymentIssue` on `GET /subscription` reckons it; null when a payment is not why. - `error` (ErrorDetail, required) ### 429 Too Many Requests Error Rate limited (`rate_limited`): the key, the signed-in person, the workspace or an expensive endpoint's own budget is used up for now. `Retry-After` says how many seconds to wait, and `details` names the `policy`, its `limit`, `windowSeconds` and `retryAfter`. Every answer to an authenticated request carries the IETF `RateLimit-Policy` and `RateLimit` headers, so a client can slow down before it gets this. Nothing was done; wait and send it again. See "Rate limits". - `error` (ErrorDetail, required) ## Types ### OverviewQuarter The workspace's current fiscal quarter, which "this quarter" means. - `year` (integer, required) — The fiscal year, as the workspace's fiscal year start names it. - `quarter` (integer, required) — 1 to 4. - `from` (datetime, required) — The quarter's first moment. - `to` (datetime, required) — The moment after it ends. ### Launch A product launch tracked on the calendar. - `id` (string, required) - `organizationId` (string, required) - `name` (string, required) - `status` (enum, required) — Where a launch sits in its lifecycle. - Allowed values: `SCOPING`, `DESIGN`, `IN_DEVELOPMENT`, `TESTING`, `LAUNCHED`, `PENDING`, `ON_HOLD` - `owners` (list of User, required) — Everybody who owns the launch. They hear about its decisions. - `teams` (list of OrgTeamRef, required) — The teams the launch belongs to. - `draft` (boolean, required) — 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`. - `stepsGenerated` (boolean, required) - `stakeholders` (list of User, required) - `stepCount` (integer, required) - `percentToLaunch` (integer, required) — Share of steps that have been approved, excepted or marked N/A. - `createdAt` (datetime, required) - `updatedAt` (datetime, required) - `description` (string, optional) - `keyCustomers` (string, optional) — The customers this launch is for, or who asked for it. Free text. - `pm` (User, optional) — The first of `owners`, from when a launch had one. Read `owners`. - `pmUserId` (string, optional) — The first owner's id. Read `owners`. - `orgTeam` (OrgTeamRef, optional) — The first of `teams`, from when a launch had one. Read `teams`. - `plannedLaunchDate` (datetime, optional) - `actualLaunchDate` (datetime, optional) - `health` (enum, optional) — As its newest update says; null until somebody posts one, and once the launch has launched. See `/launches/{launchId}/posts`. - Allowed values: `ON_TRACK`, `AT_RISK`, `OFF_TRACK` - `launchTemplateId` (string, optional) — The launch template its steps come from. See `/launch-templates`. - `launchTemplate` (LaunchTemplateRef, optional) — That template's id and name. - `ticketingProject` (TicketingProject, optional) — The ticketing project it follows, if somebody linked one. See `/launches/{launchId}/ticketing-project`. ### ErrorDetail - `code` (string, required) — A stable machine-readable code such as `not_found`. - `message` (string, required) - `details` (any, optional) ### User A person in a Taktoria organization. - `id` (string, required) - `name` (string, required) - `email` (string, required) - `image` (string, optional) — Their picture: one uploaded on the account page, or else their Google profile picture, brought in when they sign in with Google. ### OrgTeamRef An organizational team such as Eagles or Ravens. - `id` (string, required) - `name` (string, required) ### LaunchTemplateRef A launch template, by id and name. - `id` (string, required) - `name` (string, required) ### TicketingProject What a launch follows in a ticketing system: a Linear project; a Jira epic or issue (a Jira project has no status of its own, so a link to one is kept as a link); a GitHub organization's project, or a repository's milestone; an Asana project; or a ClickUp list or task. Once its system is connected to the workspace (Settings → Integrations), each day, and on a sync, its status moves the launch's; the status updates of a Linear or GitHub project become the launch's updates, and the comments on a Jira issue or a ClickUp list or task its comments (`source` on a LaunchPost; a Jira comment restricted to some people is never brought in). An Asana project's status updates need a permission Asana's OAuth does not offer Taktoria's read-only connection, so none come in. It is followed by its tasks instead: its status kind is `PLANNED` until one is done, then `STARTED`, and `COMPLETED` once the project is marked complete, and its progress is the share of them done. A whole Jira project, a GitHub repository, and a ClickUp folder or space are kept as links. Marked done, it flags the launch ready to launch; it never launches it. - `name` (string, required) - `url` (string, required) — The project's address in its system. - `system` (enum, optional) — Null for a system Taktoria has no connector for. Such a link is kept as a link and never synced. - Allowed values: `LINEAR`, `JIRA`, `GITHUB`, `ASANA`, `CLICKUP` - `statusName` (string, optional) — Its status as the system names it, as of the last sync. - `statusKind` (enum, optional) — A ticketing project's status, as one of these whichever system it is in. The launch's own status follows it when it changes. - Allowed values: `BACKLOG`, `PLANNED`, `STARTED`, `PAUSED`, `COMPLETED`, `CANCELED` - `progress` (double, optional) — 0 to 1. A Linear project's own; otherwise the share that is done of a Jira issue's child issues, a GitHub project's items or milestone's issues, an Asana project's tasks, a ClickUp list's tasks or a ClickUp task's subtasks. - `completedAt` (datetime, optional) — When the system marked it done. - `syncedAt` (datetime, optional) — The last sync that worked; null before the first. - `syncError` (string, optional) — Why the last sync failed: `notConnected` (its system is not connected to the workspace), `notFound`, `unauthorized` (a workspace admin must connect the system again), `unavailable` or `unsupported` (a system Taktoria cannot sync, or a link to something it cannot follow, such as a whole Jira project, a GitHub repository, or a ClickUp folder or space). Null when it worked. ## Examples **Response** ```json { "quarter": { "year": 2026, "quarter": 4, "from": "2026-10-01T00:00:00Z", "to": "2027-01-01T00:00:00Z" }, "inFlight": 12, "dueThisWeek": 7, "awaitingYou": 2, "launchedThisQuarter": 3, "upcoming": [ { "id": "lch_7f3a", "organizationId": "org_1", "name": "Smart Email", "status": "TESTING", "owners": [], "teams": [], "draft": false, "stepsGenerated": true, "stakeholders": [], "stepCount": 10, "percentToLaunch": 80, "createdAt": "2026-04-01T12:00:00Z", "updatedAt": "2026-10-01T12:00:00Z", "plannedLaunchDate": "2026-10-20T12:00:00Z" } ] } ``` **SDK Code** ```python import requests url = "https://api.taktoria.com/api/v1/launch-overview" headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.taktoria.com/api/v1/launch-overview'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.taktoria.com/api/v1/launch-overview" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.taktoria.com/api/v1/launch-overview") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.taktoria.com/api/v1/launch-overview") .header("Authorization", "Bearer ") .asString(); ``` ```php request('GET', 'https://api.taktoria.com/api/v1/launch-overview', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.taktoria.com/api/v1/launch-overview"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://api.taktoria.com/api/v1/launch-overview")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```