---
title: "Create new model from external source"
method: POST
path: "/v1/models"
tags: ["Models"]
---

# Create new model from external source

`POST /v1/models`

Creates a new model entry from Thangs.com or Patreon.com

## Request body

- object
  - `source` 'thangs' | 'patreon' | 'makerworld' | 'manual' | 'mmf' | 'stlflix' | 'api' — Source platform of the model
  - `name` string, required — Name of the model
  - `designer` string — Designer/creator name
  - `images` string[] — Array of image URLs
  - `sourceUrl` string — Original URL of the model
  - `sourceId` string, required — Unique identifier from the source platform
  - `description` string — Description of the model for AI tag generation
  - `generate_tags` boolean — Use AI to automatically generate relevant tags
  - `create_task` boolean — Automatically create a task for this model
  - `task_title` string — Custom task title (defaults to model name)
  - `task_description` string — Custom task description
  - `metadata` object — Additional metadata for the model
    - `modelUrl` string
    - `postId` string
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)

## Response `201`

Model created successfully

- object — Model created successfully
  - `id` string
  - `name` string
  - `designer` string
  - `images` string[]
  - `sourceUrl` string
  - `sourceId` string
  - `source` 'thangs' | 'patreon' | 'makerworld' | 'manual' | 'mmf' | 'stlflix' | 'api'
  - `metadata` object
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `rev` number
  - `deletedAt` string, date-time, nullable
  - `task` object
    - `id` string
    - `title` string
    - `swimlane_id` string

## Other responses

- `400` — Invalid request
- `500` — Internal server error

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/3b06bcb5f808/schema)