---
title: "Create Artifact"
method: POST
path: "/v2/artifacts"
tags: ["artifacts"]
---

# Create Artifact

`POST /v2/artifacts`

## Response `200`

Successful Response

- union
  - SessionResponse
    - `id` string, required
    - `type` 'session' | 'document' | 'diagram' | 'folder', required
    - `name` string, required
    - `space_id` string, required
    - `folder_ids` string[]
    - `created_at` string, required
    - `last_content_updated_at` string, nullable — Last time the document or diagram content itself changed; unchanged by renames and moves. Null for sessions.
    - `external_ids` object
    - `content_url` string, required
    - `status` string, required
    - `start_time` string, required
    - `transcript` Utterance[], required
      - `start_time` number, required
      - `end_time` number, required
      - `speaker` string, required
      - `words` string, required
    - `summary` string, nullable
    - `action_items` object[]
    - `qa_pairs` object[]
  - DocumentResponse
    - `id` string, required
    - `type` 'session' | 'document' | 'diagram' | 'folder', required
    - `name` string, required
    - `space_id` string, required
    - `folder_ids` string[]
    - `created_at` string, required
    - `last_content_updated_at` string, nullable — Last time the document or diagram content itself changed; unchanged by renames and moves. Null for sessions.
    - `external_ids` object
    - `document_content` string, nullable
    - `content_url` string, nullable
  - ArtifactListItem
    - `id` string, required
    - `type` 'session' | 'document' | 'diagram' | 'folder', required
    - `name` string, required
    - `space_id` string, required
    - `folder_ids` string[]
    - `created_at` string, required
    - `last_content_updated_at` string, nullable — Last time the document or diagram content itself changed; unchanged by renames and moves. Null for sessions.
    - `external_ids` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getauctor/apis/fastapi.md) · [All operations](https://skmtc.dev/getauctor/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getauctor/fastapi/revisions/aeb6faa3b8f0/schema)