---
title: "Create Element"
method: POST
path: "/api/elements"
tags: ["elements"]
---

# Create Element

`POST /api/elements`

## Request

- Base URL: `https://api.tintin-x.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tintin-x.com/api/elements`
- Auth: HTTP bearer

## Request body

- CreateElementRequest
  - `name` string, required
  - `element_type` string, required: One of: product, character, model, scene, brand, document, dataset, custom
  - `description` string, nullable
  - `usage_instructions` string, nullable
  - `tags` string[], nullable
  - `visibility` string: private, team, or specific
  - `files` InlineFileRef[], nullable: Files to attach inline (by s3_key or file_id)
    - `s3_key` string, nullable
    - `file_id` string, uuid, nullable
    - `filename` string, nullable
    - `content_type` string, nullable
    - `description` string, nullable
    - `role` string
  - `agent_id` string, uuid, nullable: Agent creating this element (for auto-tracking files)

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tintin-x/apis/tintin-api.md) · [All operations](https://skmtc.dev/tintin-x/apis/tintin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tintin-x/apis/tintin-api/revisions/8839a8d0a66c?raw)