---
title: "Ingest a remote model file by URL"
method: POST
path: "/v1/models/{modelId}/files/ingest-url"
tags: ["Models", "Public"]
---

# Ingest a remote model file by URL

`POST /v1/models/{modelId}/files/ingest-url`

Downloads a remote model artifact (MakerWorld or a direct file URL) and registers it as a Model File. Not a farm-motion surface.

## Path parameters

- `modelId` string, required

## Request body

- object
  - `url` string, required
  - `filename` string

## Response `200`

Default Response

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-09-12** `8930a0567d10` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/models/:modelId/files/ingest-url/post.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/5c8170e25e84?raw)