---
title: "Create Graph Project"
method: POST
path: "/graph-project"
---

# Create Graph Project

`POST /graph-project`

## Request

- Base URL: `https://api.iliad.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.iliad.ai/graph-project`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Request body

- CreateGraphProjectRequest
  - `display_name` string, nullable
  - `workspace_id` string, nullable
  - `workspace` string, nullable
  - `content` GraphProjectContent: The user-editable graph document that JSON Patches modify directly.
    - `resolution` integer
    - `animation` AnimationClip: One authored source-time range, shared by preview and export.
      - `preview_mode` 'free' | 'clip'
      - `start` number, required
      - `duration` number, required
      - `playback` 'loop' | 'once'
      - `sampling` union, required
        - FrameSampling
          - `mode` 'frames'
          - `count` integer, required
        - TargetFpsSampling
          - `mode` 'target_fps'
          - `rate` number, required
    - `normal_format` 'opengl' | 'directx'
    - `outputs` object
    - `output_positions` object, nullable
    - `output_order` string[]
    - `output_formats` object
    - `nodes` object
    - `notes` object
    - `frames` object
    - `reroutes` object
    - `portals` object
    - `portal_exits` object
    - `custom_nodes` object: Embedded definitions keyed by hyphenated UUID; instances reference that UUID in kind.

## Response `200`

Successful Response

- CreateGraphProjectResponse
  - `graph_project_id` string, required
  - `display_name` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `42e7efcd04ea`: 1 warning, 7 info
  - removed the request property `content/anyOf[subschema #1: GraphProjectContent]/custom_nodes/additionalProperties/platforms`
  - added the new optional request property `content/anyOf[subschema #1: GraphProjectContent]/custom_nodes/additionalProperties/editor_artifacts`
  - added `subschema #4` to the `content/anyOf[subschema #1: GraphProjectContent]/nodes/additionalProperties/params/additionalProperties/` request property `anyOf` list
  - added `subschema #5` to the `content/anyOf[subschema #1: GraphProjectContent]/custom_nodes/additionalProperties/params/items/default` request property `anyOf` list
  - …4 more
- **2026-10-14** `012b4a7e1491`: 1 info
  - the `custom_nodes` request property default value `{}` was removed
- **2026-10-09** `c61646f09e21`: 1 info
  - added the new optional request property `content/anyOf[subschema #1: GraphProjectContent]/animation`
- **2026-10-06** `841658052334`: 1 info
  - added the new optional request property `content/anyOf[subschema #1: GraphProjectContent]/custom_nodes/additionalProperties/clamp_output`
- …earlier changes not shown

[Operation history](https://skmtc.dev/iliad/apis/iliad-api/changes/graph-project/post.md)

---

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