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.
| Choice | Gives |
|---|---|
| Copy link | The page's address. Anyone signed in to the same account opens the same view |
| Copy API call | A 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 view | Keeps 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.
| On | Copy API call gives |
|---|---|
| Passes, upcoming and past | GET /predictions?workflow=<slug>, narrowed with station_id, antenna_id or satellite_id; a pinned report reads ?run_id= |
| Forecasts › Scenarios | GET /predictions?workflow=<slug>&scenario_id=<id>, or GET /topology/scenarios for the list |
| Automations | GET /predictions/workflows, or one workflow's GET /predictions/workflows/{slug} |
| Fleet | GET /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.