Your progress is only saved in this browser. to protect it and pick up on any device.

Connect a Postman API key to check your work

You do each step in Postman, then LiftOff uses your key to look at your workspace and confirm it's done. Connect once and it works for every module. Your key is saved in this browser and is only used to check your work in Postman.

0 of 4 steps0%
1

Create a Blank Workspace

A dedicated workspace keeps your Artemis mission resources organized and separate from other work.

  1. Open the Postman desktop app. If you don't have it yet, download Postman and sign in — if you're already signed in, you're good to go.
  2. Click Workspaces in the top navigation → Create.
  3. On the Create your workspace form, in Workspace name enter Artemis II - [your name] (e.g. Artemis II - Alex).
text
Artemis II -
  1. For Who can access, open the dropdown and choose Only you and invited people — Internal is already selected.
  2. Leave the template on Blank workspace (already selected), then click Create Workspace.
2

Import the OpenAPI Spec

  1. Click the Import button on the top right of the left navigation bar
  2. Paste this URL:
https://raw.githubusercontent.com/mishra-aanchal/artemis-mission-control-api-workshop/refs/heads/main/openapi.yaml
  1. Press Enter to fetch the spec
  2. You will see a prompt. Select the 'OpenAPI 3.1 Specification with a Postman Collection' option and click Import

Postman auto-generates a collection from the spec with all the Artemis API endpoints ready to use.

3

Create an Environment

An environment holds variables you reuse across requests. Create artemis.local with baseUrl, apiKey, and logId — either with Agent Mode or by hand.

Option A — Agent Mode

  1. Open Agent Mode from the button in the bottom-right of the sidebar
  2. Enter this prompt:

Create an environment called artemis.local with variables - baseUrl, apiKey and logId.

  1. Verify the environment artemis.local appears with all three variables

Option B — Manual

  1. In the left sidebar, click Environments
  2. Click + (or Environment) and name it:
text
artemis.local
  1. In the variables table, add three variables: baseUrl, apiKey, and logId (leave the values empty for now — you'll set them in the next step)
  2. Save the environment (Ctrl/Cmd+S)
  3. Select artemis.local from the environment selector in the top right
4

Update Environment Variables

LiftOff checks non-secret environment values (like baseUrl) through the Postman API, which can only read the Shared Value column — not the local Value column. If you only fill Value for baseUrl, validation fails even when the URL looks right in Postman.

Do not put secrets such as apiKey in Shared Value. Keep those in the local Value column instead — you'll set the key after registration.

  1. If artemis.local is already open from the previous step, stay on that tab. Otherwise, open Environments in the left sidebar and select artemis.local.
  2. If you don't see a Shared Value column, click the menu at the far right of the variables table header → Show as column → check Shared Value.
  3. On the baseUrl row, paste this into the Shared Value column (you can put the same URL in Value too):
https://artemis.up.railway.app
  1. Leave apiKey and logId empty for now — you'll fill apiKey after you register in Part 2.
  2. Optional: on the apiKey row, set the type to Secure (lock icon) so the value stays hidden when you add it later.
  3. Click Save (Ctrl/Cmd+S).

Your table should look like this — baseUrl filled in both columns, apiKey and logId empty:

The artemis.local environment Variables table with baseUrl set to https://artemis.up.railway.app in both Value and Shared Value, apiKey marked Secure and empty, and logId empty

Why this step trips people up: For baseUrl, a value only in Value stays on your machine. Shared Value syncs to the Postman cloud — that's what LiftOff can read for non-secret config. Filling the wrong column is the #1 reason this step fails validation.

Troubleshooting:

  • Validation says baseUrl is empty → the URL is missing from Shared Value. Copy it into that column, Save, wait a few seconds, then validate again.
  • Validation says the URL is wrong → it must be exactly https://artemis.up.railway.app (no trailing slash, no typo).
  • Can't find Shared Value → use the column menu in step 2 above.