---
title: "Ingest a scouting photo from a URL as an asset"
method: POST
path: "/api/vortex/upload-image-from-url"
tags: ["Vortex"]
---

# Ingest a scouting photo from a URL as an asset

`POST /api/vortex/upload-image-from-url`

## Request

- Base URL: `https://api.sponsorunited.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sponsorunited.com/api/vortex/upload-image-from-url`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/sponsorunited/apis/sponsorunited-api/docs/api/vortex/upload-image-from-url/post.ts> (a function with typed inputs; its response is checked against the schema)

Pulls an image from the provided URL, stores it on S3 as an asset, and returns the created Image record. The returned id can be attached to a scouting audit via items.*.images.*.id on POST /api/vortex/audit/bulk. Always creates an asset (type is fixed server-side). Authenticated via X-API-Key.

## Request body

- UploadImageFromUrlRequest: Request schema for uploading an image from a URL to S3
  - `url` string, url, required: The URL of the image to upload
  - `type` string, nullable: The upload type category

## Response `201`

Asset created successfully

- Image
  - `id` integer
  - `storage` string
  - `folder` string
  - `original_name` string
  - `stored_name` string
  - `needs_check` integer
  - `blurhash` string
  - `hammhash` string
  - `original_url` string
  - `image_url` string
  - `resized_image_url` string
  - `enhanced_image_url` string
  - `extension` string
  - `mime_type` string
  - `exif` string
  - `file_size` string
  - `width` string
  - `height` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `deleted_at` string, date-time

## Other responses

- `401`: Unauthenticated
- `422`: Validation error or invalid image

---

[API](https://skmtc.dev/sponsorunited/apis/sponsorunited-api.md) - [All operations](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sponsorunited/apis/sponsorunited-api/revisions/cbf1ca5bff8f?raw)