---
title: "Run a multi-step spatial pipeline"
method: POST
path: "/compute"
tags: ["compute"]
---

# Run a multi-step spatial pipeline

`POST /compute`

## Request

- Base URL: `https://api.mapsource.io`
- URL: `https://api.mapsource.io/compute`
- Auth: HTTP bearer

Executes up to 12 ordered steps with references to earlier results and returns the selected output.

When to use: Run dependent search, navigation, and analysis without downloading intermediate results.

When not to use: Call the relevant endpoint directly for a single operation.

## Request body

- object
  - `pipeline` unknown[], required: Ordered steps of {id, op, args}.
    - unknown
  - `return` string: Which step to return, as $stepId. Defaults to the last.
  - `estimateOnly` boolean: Report the cost without executing.

## Response `200`

Run a multi-step spatial pipeline

- object
  - `schema` string
  - `returns` string
  - `steps` unknown[]
    - unknown
  - `data` unknown
  - `result` object
  - `meta` object
    - `requestId` string
    - `computeMs` integer
    - `requestedAt` string, date-time
    - `sources` object[]
      - `dataset` string
      - `observedAt` string, nullable
      - `license` string
    - `freshness` object, nullable
    - `licenses` string[]
    - `attribution` string[]

## Other responses

- `400`: Error with a stable machine code.
- `401`: Error with a stable machine code.
- `429`: Error with a stable machine code.
- `500`: Error with a stable machine code.

---

[API](https://skmtc.dev/mapsource/apis/mapsource-overpass-api.md) · [All operations](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapsource/apis/mapsource-overpass-api/revisions/8af8c2769e7b?raw)