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

# Create Artifact

`POST /v2/artifacts`

## Request

- Base URL: `https://api.getauctor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getauctor.com/v2/artifacts`
- Auth: none declared

## Request body `multipart/form-data`

- BodyCreateArtifactV2ArtifactsPost
  - `type` 'session' | 'document' | 'folder', required
  - `space_id` string, required
  - `name` string, required
  - `file` string, binary, nullable
  - `file_url` string, nullable
  - `source_format` string, nullable
  - `start_time` string, nullable
  - `folder_id` string, nullable

## 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

## Changes

- **2026-09-01** `aeb6faa3b8f0`: 4 info
  - added the new optional request property `source_format`
  - added the optional property `anyOf[subschema #1: SessionResponse]/last_content_updated_at` to the response with the `200` status
  - added the optional property `anyOf[subschema #2: DocumentResponse]/last_content_updated_at` to the response with the `200` status
  - added the optional property `anyOf[subschema #3: ArtifactListItem]/last_content_updated_at` to the response with the `200` status

[Operation history](https://skmtc.dev/getauctor/apis/getauctor-api/changes/v2/artifacts/post.md)

---

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