Eve library

ISIS v2 External Integration Cookbook

Guide

Revision 1

On this page

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