---
title: "What the org has set up so far, and what to do next"
method: GET
path: "/me/setup"
tags: ["identity"]
---

# What the org has set up so far, and what to do next

`GET /me/setup`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/me/setup`
- Auth: none declared

## Query parameters

- `orgId` string

## Response `200`

Setup progress

- SetupProgress
  - `orgId` string, required
  - `reachedCount` integer, required
  - `totalCount` integer, required
  - `complete` boolean, required
  - `next` 'workspace' | 'first_mission' | 'first_review' | 'first_merge' | 'preview_deployment' | 'agent_instructions' | 'mcp_servers' | 'custom_sandbox' | 'teammate' | 'steer_mission' | 'checkpoints' | 'scheduled_task' | 'agent_to_pr', nullable, required
  - `activeGroup` 'first_mission' | 'team' | 'explore', nullable, required
  - `activeGroupProgress` object, nullable, required
    - `reachedCount` integer, required
    - `totalCount` integer, required
  - `groups` SetupGroup[], required
    - `id` 'first_mission' | 'team' | 'explore', nullable, required
    - `title` string, required
    - `reachedCount` integer, required
    - `totalCount` integer, required
    - `complete` boolean, required
    - `milestones` SetupMilestone[], required
      - `id` 'workspace' | 'first_mission' | 'first_review' | 'first_merge' | 'preview_deployment' | 'agent_instructions' | 'mcp_servers' | 'custom_sandbox' | 'teammate' | 'steer_mission' | 'checkpoints' | 'scheduled_task' | 'agent_to_pr', nullable, required
      - `title` string, required
      - `description` string, required
      - `reached` boolean, required
      - `status` 'open' | 'reached' | 'completed' | 'skipped', required
      - `action` SetupAction, nullable, required
        - `label` string, required
        - `path` string, required
        - `url` string, uri, required
      - `docsUrl` string, uri, nullable, required
  - `firstMission` object, nullable, required
    - `issueId` string, required
    - `orgSlug` string, required
    - `url` string, uri, required
  - `guides` SetupGuide[], required
    - `id` 'mission-control' | 'mission-detail' | 'mission-results', required
    - `step` integer, required
    - `completedAt` integer, nullable, required

## Other responses

- `401`: Unauthenticated
- `404`: Not one of the caller's orgs
- `503`: SITE_URL is not set, so the steps cannot link to the console (code not_configured)

---

[API](https://skmtc.dev/letsship/apis/ship-api.md) · [All operations](https://skmtc.dev/letsship/apis/ship-api/llms.txt) · [OpenAPI document](https://skmtc.dev/letsship/apis/ship-api/revisions/e6eac1bcadd4?raw)