---
canonical_url: "https://docs.composio.dev/toolkits/mapflow"
markdown_url: "https://docs.composio.dev/toolkits/mapflow.md"
product: "platform"
version: null
last_updated: null
---

# Mapflow.ai

Mapflow.ai analyzes satellite and aerial imagery with AI, manages geospatial processing projects, and provides custom imagery and catalog workflows.

- **Category:** artificial intelligence
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 10
- **Triggers:** 0
- **Slug:** `MAPFLOW`
- **Version:** 00000000_00

## Tools

### Create Processing (Consumes Credits)

**Slug:** `MAPFLOW_CREATE_PROCESSING`

CREDIT-CONSUMING: create and immediately start an asynchronous v2 imagery-analysis processing. Estimate first, verify the account balance and limits, then poll MAPFLOW_GET_PROCESSING every 30-60 seconds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meta` | object | No | Optional caller metadata to associate with the processing. |
| `name` | string | Yes | Human-readable processing name. |
| `blocks` | array | No | Optional model blocks and whether each is enabled; blocks may add cost. |
| `geometry` | string | Yes | Closed GeoJSON analysis area within the account's current limits. |
| `project_id` | string | Yes | Destination project UUID from MAPFLOW_LIST_PROJECTS. |
| `description` | string | No | Optional processing description. |
| `workflow_id` | string | No | Model or workflow ID from MAPFLOW_GET_ACCOUNT_CAPABILITIES. Provide exactly one of workflow_id or workflow_name. |
| `source_params` | object | Yes | Exactly one documented source family: dataProvider, myImagery, imagerySearch, or userDefined. |
| `workflow_name` | string | No | Model or workflow name. Provide exactly one of workflow_id or workflow_name; prefer the stable ID. |
| `inference_params` | object | No | Optional model-specific inference parameters for the selected model. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project

**Slug:** `MAPFLOW_CREATE_PROJECT`

Create a Mapflow project container for organizing imagery-analysis processings. This does not start processing or consume processing credits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name for the new project. |
| `description` | string | No | Optional project description. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Processing Result

**Slug:** `MAPFLOW_DOWNLOAD_PROCESSING_RESULT`

Download a completed processing's vector result as a GeoJSON file, optionally restricted to one AOI. Call only after MAPFLOW_GET_PROCESSING reports status OK.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `aoi_id` | string | No | Optional AOI ID to restrict the GeoJSON result. Omit it to download the full processing result. |
| `processing_id` | string | Yes | UUID of a processing whose status is OK. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Estimate Processing Cost

**Slug:** `MAPFLOW_ESTIMATE_PROCESSING_COST`

Estimate the credit cost of a v2 processing without starting it or consuming credits. Provide a model workflow ID and at least one of geometry or area_sq_km.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `blocks` | array | No | Optional model blocks whose enabled prices should be included in the estimate. |
| `geometry` | string | No | Closed GeoJSON Polygon or MultiPolygon analysis geometry. Required when area_sq_km is omitted. |
| `area_sq_km` | string | No | Analysis area in square kilometres. Required when geometry is omitted. |
| `workflow_id` | string | Yes | Available model or workflow ID from MAPFLOW_GET_ACCOUNT_CAPABILITIES. |
| `source_params` | object | No | Optional imagery source configuration matching MAPFLOW_CREATE_PROCESSING. |
| `inference_params` | object | No | Optional model-specific inference parameters matching MAPFLOW_CREATE_PROCESSING. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Capabilities

**Slug:** `MAPFLOW_GET_ACCOUNT_CAPABILITIES`

Return the connected Mapflow account's credit balance, processing and storage limits, available AI models and optional blocks, and imagery providers. Use this before estimating or starting a processing.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Processing

**Slug:** `MAPFLOW_GET_PROCESSING`

Get detailed status, progress, cost, errors, source configuration, and result-layer metadata for one current v2 processing. Poll no more often than every 30-60 seconds while it is running.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `processing_id` | string | Yes | UUID of the v2 processing to inspect. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Storage Overview

**Slug:** `MAPFLOW_GET_STORAGE_OVERVIEW`

Return custom-imagery storage limits and usage together with the account's mosaics, so an agent can select existing uploaded imagery without separate discovery calls.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Processings

**Slug:** `MAPFLOW_LIST_PROCESSINGS`

List current v2 processings. Omit project_id for the connected account's personal list, or provide project_id to include processings in a specific visible personal, shared, or team project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | string | No | Project UUID to list within. Omit for the personal account-wide list; that list may exclude visible shared or team project processings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Projects

**Slug:** `MAPFLOW_LIST_PROJECTS`

List projects visible to the connected account, including personal and shared or team projects and the IDs needed to scope processing operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Imagery Catalog

**Slug:** `MAPFLOW_SEARCH_IMAGERY_CATALOG`

Search external imagery providers linked to the connected account for scenes or mosaics intersecting a GeoJSON AOI. Available inventory depends on account and provider entitlements; route access does not imply commercial imagery access.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `aoi` | object | Yes | Search area within the account's searchAreaLimit from account capabilities. |
| `limit` | integer | No | Maximum products in this page. |
| `offset` | integer | No | Zero-based result offset for the first page. |
| `sort_by` | string | No | Provider-supported sort field, for example ACQUISITION_DATE. |
| `sort_order` | string ("ASC" | "DESC") | No | Sort direction. |
| `next_cursor` | string | No | Opaque cursor returned by a previous call. Pass it with the same aoi to fetch the next page; the cursor supplies the next offset and replays the search filters that produced it, so resent filter values are ignored. |
| `product_types` | array | No | Restrict results to image scenes and/or mosaics. |
| `data_providers` | array | No | Provider names from searchDataProviders in account capabilities. |
| `max_resolution` | number | No | Maximum pixel resolution in metres per pixel. |
| `min_resolution` | number | No | Minimum pixel resolution in metres per pixel. |
| `max_cloud_cover` | number | No | Maximum cloud-cover percentage. |
| `hide_unavailable` | boolean | No | Whether to omit products unavailable to the connected account. |
| `acquisition_date_to` | string | No | Latest acquisition date/time in ISO 8601 format. |
| `max_off_nadir_angle` | number | No | Maximum off-nadir angle in degrees. |
| `min_off_nadir_angle` | number | No | Minimum off-nadir angle in degrees. |
| `acquisition_date_from` | string | No | Earliest acquisition date/time in ISO 8601 format. |
| `min_aoi_intersection_percent` | number | No | Minimum percentage of the AOI intersected by a product. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |