---
title: "/api/v2/ingestor/upload_sessions"
method: POST
path: "/api/v2/ingestor/upload_sessions"
---

# /api/v2/ingestor/upload_sessions

`POST /api/v2/ingestor/upload_sessions`

## Request

- Base URL: `https://app-legacy.raptormaps.com`
- URL: `https://app-legacy.raptormaps.com/api/v2/ingestor/upload_sessions`
- Auth: API key in header `Authorization`

Endpoint that signals Raptor App's ingestors to create a new upload session and pull in your data. Data is sent as a list of URLs where each image corresponds to one URL.

## Query parameters

- `org_id` integer

## Request body

- object
  - `order_id` integer: Order ID to associate upload sessions to
  - `data_url` string: URL or list of URLs where the data is available for retrieval by Raptor Maps. For performance reasons, we recommend not sending more than 1000 image urls per post request. For example, if your data resides on AWS S3, you may sign the S3 keys so that the the data_url may be something like ['https://my-s3-bucket.s3-accelerate.amazonaws.com/path/to/IMG_0001.jpg?AWSAccessKeyId=ABCD1234&Expires=1560526525&Signature=EFGH5678%3D', 'https://my-s3-bucket.s3-accelerate.amazonaws.com/path/to/IMG_0002.jpg?AWSAccessKeyId=ABCD1234&Expires=1560526525&Signature=EFGH5678%3D']
  - `pipeline` string: Either "om" or "epc" to indicate the data is for the Operations and Maintenance analytics pipeline of Engineering Procurement and Construction pipeline.
  - `upload_session_name` string: A name that describes the upload session and data. For example: "Goldie Solar - Section A - RGB"

## Response `200`

200

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/raptormaps/apis/raptor-app-legacy-api.md) - [All operations](https://skmtc.dev/raptormaps/apis/raptor-app-legacy-api/llms.txt) - [OpenAPI document](https://skmtc.dev/raptormaps/apis/raptor-app-legacy-api/revisions/1a47e4d75bb4?raw)