---
title: "Get Graph Project"
method: GET
path: "/graph-project/{graph_project_id}"
---

# Get Graph Project

`GET /graph-project/{graph_project_id}`

## 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/{graph_project_id}`
- Auth: OAuth 2
  - Password
  - Token URL: `token`

## Path parameters

- `graph_project_id` string, required

## Response `200`

Successful Response

- GetGraphProjectResponse
  - `graph_project_id` string, required
  - `workspace_id` string, required
  - `created_by_user_id` string, required
  - `capabilities` string[], required
  - `display_name` string, required
  - `content` GraphProjectContent, required: 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.
  - `version` integer, required
  - `created_at` string, required
  - `last_updated_at` string, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `42e7efcd04ea`: 1 breaking, 2 warning, 5 info
  - response property `content/custom_nodes/additionalProperties/category` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed the optional property `content/custom_nodes/additionalProperties/platforms` from the response with the `200` status
  - added the new `curve` enum value to the `content/custom_nodes/additionalProperties/params/items/type` response property for the response status `200`
  - added the optional property `content/custom_nodes/additionalProperties/editor_artifacts` to the response with the `200` status
  - …4 more
- **2026-10-14** `012b4a7e1491`: 1 info
  - the `custom_nodes` response's property default value `{}` was removed for the status `200`
- **2026-10-09** `c61646f09e21`: 1 info
  - added the optional property `content/animation` to the response with the `200` status
- **2026-10-06** `841658052334`: 1 info
  - added the optional property `content/custom_nodes/additionalProperties/clamp_output` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/iliad/apis/iliad-api/changes/graph-project/:graph_project_id/get.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)