Skip to main content

Share a view, or copy the API call behind it

What a tab shows lives in its address: the workflow, scope and window from the context bar, the filter or breakdown you picked, and the pass or asset you opened. So a link to a view is the view, and the same fields make the API call that returns its data.

Share​

Share, at the right of the view pane's title row on Fleet, Passes, Forecasts and Automations, beside the workflow, scope and window, opens its menu: Copy link, Copy API call where the view has one, and Save view. The button says Copied or Saved, then goes back.

ChoiceGives
Copy linkThe page's address. Anyone signed in to the same account opens the same view
Copy API callA curl command for the read behind the view, its method and path shown beside it. The key is $CONSTELLATION_API_KEY, never the secret, so a pasted command keeps no key in your shell history
Save viewKeeps the view in this browser under a name made from it, such as the tab, workflow, scope and window. ⌘K lists it

Integrations and Settings are not views of fleet data, so they have no Share.

OnCopy API call gives
Passes, upcoming and pastGET /predictions?workflow=<slug>, narrowed with station_id, antenna_id or satellite_id; a pinned report reads ?run_id=
Forecasts › ScenariosGET /predictions?workflow=<slug>&scenario_id=<id>, or GET /topology/scenarios for the list
AutomationsGET /predictions/workflows, or one workflow's GET /predictions/workflows/{slug}
FleetGET /topology/config

Forecasts › Models has no Copy API call: the model catalog (GET /catalog/models) answers a sign-in, not an API key.

One pass, one report​

  • A pass on Passes has its own Copy link and Copy API call (GET /predictions?workflow=<slug>&pass_id=<id>) at the foot of its detail pane.
  • An audit report on Passes, Past, has Copy report link, which opens that report for anyone signed in to your account.

Find it again​

⌘K, or Search or ask in the top bar, opens search. Type a satellite, a station or a tab, or ask a question such as passes at Svalbard tomorrow. Saved views lists what you saved; with one highlighted, Forget under the list, or Shift+Delete, removes it. Saved views stay in this browser only; to hand one to a teammate, copy its link.

Run the call​

export CONSTELLATION_API_KEY=cos_live_... # a live key with predictions:read
curl -s "https://api.constellation.space/predictions?workflow=pass-yield&station_id=svalbard" \
-H "x-api-key: $CONSTELLATION_API_KEY"

The answer is in the shared response shape. Each read needs its own scope; see Auth and scopes.