# ISIS v2 External Integration Cookbook

Generated: 2026-03-06T11:19:09.395Z Scope: `WS16-004`

## Summary

- Game engine targets: 3
- Film toolchain targets: 3
- Integration lanes: 6
- Chain workflow references: 18
- Batch workflow references: 12
- Webhook default event types: 5
- Workflow trigger endpoints: 3
- Webhook endpoints: 13
- Missing workflow references: none

## Workflow Trigger Contracts

| Method | Path                                 | SDK Method               |
| ------ | ------------------------------------ | ------------------------ |
| POST   | `/api/v1/workflows/:workflowId/run`  | `workflows.run`          |
| POST   | `/api/v1/workflows/triggers/batch`   | `workflows.triggerBatch` |
| POST   | `/api/v1/workflows/triggers/chained` | `workflows.triggerChain` |

## Webhook Subscription and Callback Contracts

| Method | Path                                                          | SDK Method                                   |
| ------ | ------------------------------------------------------------- | -------------------------------------------- |
| GET    | `/api/v1/webhook-subscriptions/event-types`                   | `generation.getWebhookEventTypes`            |
| GET    | `/api/v1/webhook-subscriptions/event-schemas`                 | `generation.listWebhookEventSchemas`         |
| GET    | `/api/v1/webhook-subscriptions/event-schemas/:eventType`      | `generation.getWebhookEventSchema`           |
| POST   | `/api/v1/webhook-subscriptions/callback-security/sign`        | `generation.signWebhookCallback`             |
| POST   | `/api/v1/webhook-subscriptions/callback-security/verify`      | `generation.verifyWebhookCallback`           |
| POST   | `/api/v1/webhook-subscriptions`                               | `generation.createWebhookSubscription`       |
| GET    | `/api/v1/webhook-subscriptions`                               | `generation.listWebhookSubscriptions`        |
| GET    | `/api/v1/webhook-subscriptions/:subscriptionId`               | `generation.getWebhookSubscription`          |
| PATCH  | `/api/v1/webhook-subscriptions/:subscriptionId`               | `generation.updateWebhookSubscription`       |
| DELETE | `/api/v1/webhook-subscriptions/:subscriptionId`               | `generation.deleteWebhookSubscription`       |
| POST   | `/api/v1/webhook-subscriptions/:subscriptionId/activate`      | `generation.activateWebhookSubscription`     |
| POST   | `/api/v1/webhook-subscriptions/:subscriptionId/pause`         | `generation.pauseWebhookSubscription`        |
| POST   | `/api/v1/webhook-subscriptions/:subscriptionId/rotate-secret` | `generation.rotateWebhookSubscriptionSecret` |

## Default Webhook Event Types

- `job.completed`
- `job.failed`
- `workflow.execution.completed`
- `workflow.execution.failed`
- `output.created`

## Game Engine Recipes

### Godot stylized world lane

- Lane ID: `godot-content-lane`
- Target: `godot`
- Webhook endpoint template: `/webhooks/isis/engine/godot/{projectId}`
- Output package profiles: `game-ready-3d-profile`, `image-single-profile`,
  `video-master-profile`
- Chain workflows: `environment-map` (texture), `style-transfer` (utility),
  `image-to-video` (video)
- Batch workflows: `mandala-generator` (sacred-art), `visionary-art`
  (sacred-art)
- Required engine bundle config: `project.godot`

Example chain trigger request:

```json
{
  "idempotencyKey": "engine:godot:chain:{environment}:{projectId}",
  "chainId": "godot-chain-{projectId}",
  "stopOnFailure": true,
  "steps": [
    {
      "stepId": "godot-step-01",
      "workflowId": "environment-map"
    },
    {
      "stepId": "godot-step-02",
      "workflowId": "style-transfer"
    },
    {
      "stepId": "godot-step-03",
      "workflowId": "image-to-video"
    }
  ]
}
```

### Unity character content lane

- Lane ID: `unity-content-lane`
- Target: `unity`
- Webhook endpoint template: `/webhooks/isis/engine/unity/{projectId}`
- Output package profiles: `image-single-profile`
- Chain workflows: `base-avatar` (avatar), `consistent-character` (avatar),
  `cosmetic-layer` (avatar)
- Batch workflows: `face-swap` (avatar), `style-transfer` (utility)
- Required engine bundle config: `ProjectSettings/ProjectSettings.asset`

Example chain trigger request:

```json
{
  "idempotencyKey": "engine:unity:chain:{environment}:{projectId}",
  "chainId": "unity-chain-{projectId}",
  "stopOnFailure": true,
  "steps": [
    {
      "stepId": "unity-step-01",
      "workflowId": "base-avatar"
    },
    {
      "stepId": "unity-step-02",
      "workflowId": "consistent-character"
    },
    {
      "stepId": "unity-step-03",
      "workflowId": "cosmetic-layer"
    }
  ]
}
```

### Unreal cinematic asset lane

- Lane ID: `unreal-content-lane`
- Target: `unreal`
- Webhook endpoint template: `/webhooks/isis/engine/unreal/{projectId}`
- Output package profiles: `game-ready-3d-profile`, `image-single-profile`
- Chain workflows: `stable-zero123` (3d), `3d-texture` (texture),
  `upscale-enhance` (utility)
- Batch workflows: `environment-map` (texture), `style-transfer` (utility)
- Required engine bundle config: `Config/DefaultEngine.ini`

Example chain trigger request:

```json
{
  "idempotencyKey": "engine:unreal:chain:{environment}:{projectId}",
  "chainId": "unreal-chain-{projectId}",
  "stopOnFailure": true,
  "steps": [
    {
      "stepId": "unreal-step-01",
      "workflowId": "stable-zero123"
    },
    {
      "stepId": "unreal-step-02",
      "workflowId": "3d-texture"
    },
    {
      "stepId": "unreal-step-03",
      "workflowId": "upscale-enhance"
    }
  ]
}
```

## Film Toolchain Recipes

### Blender asset round-trip automation

- Lane ID: `blender-automation-lane`
- Target: `blender`
- Webhook endpoint template: `/webhooks/isis/dcc/blender/{projectId}`
- Output package profiles: `game-ready-3d-profile`, `image-single-profile`,
  `marketing-campaign-profile`
- Chain workflows: `artifact-reconstruction` (3d), `3d-texture` (texture),
  `upscale-enhance` (utility)
- Batch workflows: `batch-resize` (utility), `batch-watermark` (utility)
- Required DCC bundle config: `config/blender_import.py`
- Default interchange format: `fbx`

Example batch trigger request:

```json
{
  "idempotencyKey": "dcc:blender:batch:{environment}:{projectId}",
  "continueOnError": true,
  "triggers": [
    {
      "workflowId": "batch-resize",
      "reference": "blender-pass-a"
    },
    {
      "workflowId": "batch-watermark",
      "reference": "blender-pass-b"
    }
  ]
}
```

### Houdini FX concept automation

- Lane ID: `houdini-automation-lane`
- Target: `houdini`
- Webhook endpoint template: `/webhooks/isis/dcc/houdini/{projectId}`
- Output package profiles: `image-single-profile`, `video-master-profile`
- Chain workflows: `fractal-art-fusion` (fractal), `fractal-morph` (fractal),
  `image-to-video` (video)
- Batch workflows: `fractal-zoom` (fractal), `flame-fractal` (fractal)
- Bundle note: No dedicated DCC bundle helper is currently implemented for this
  target.

Example batch trigger request:

```json
{
  "idempotencyKey": "dcc:houdini:batch:{environment}:{projectId}",
  "continueOnError": true,
  "triggers": [
    {
      "workflowId": "fractal-zoom",
      "reference": "houdini-pass-a"
    },
    {
      "workflowId": "flame-fractal",
      "reference": "houdini-pass-b"
    }
  ]
}
```

### Maya character lookdev automation

- Lane ID: `maya-automation-lane`
- Target: `maya`
- Webhook endpoint template: `/webhooks/isis/dcc/maya/{projectId}`
- Output package profiles: `image-single-profile`
- Chain workflows: `base-avatar` (avatar), `consistent-character` (avatar),
  `cosmetic-layer` (avatar)
- Batch workflows: `background-removal` (utility), `style-transfer` (utility)
- Required DCC bundle config: `config/maya_import.mel`
- Default interchange format: `fbx`

Example batch trigger request:

```json
{
  "idempotencyKey": "dcc:maya:batch:{environment}:{projectId}",
  "continueOnError": true,
  "triggers": [
    {
      "workflowId": "background-removal",
      "reference": "maya-pass-a"
    },
    {
      "workflowId": "style-transfer",
      "reference": "maya-pass-b"
    }
  ]
}
```

## Export Bundle Compatibility

### Engine Bundles

| Target   | Required Config File                    |
| -------- | --------------------------------------- |
| `unreal` | `Config/DefaultEngine.ini`              |
| `unity`  | `ProjectSettings/ProjectSettings.asset` |
| `godot`  | `project.godot`                         |

### DCC Bundles

| Target    | Required Config File       | Default Interchange |
| --------- | -------------------------- | ------------------- |
| `blender` | `config/blender_import.py` | `fbx`               |
| `maya`    | `config/maya_import.mel`   | `fbx`               |
