SoulFire LogoSoulFire

Update script

Updates an existing script's metadata and/or node graph. Only specified fields are updated; others remain unchanged. Use update_nodes/update_edges flags to explicitly set empty lists.

PATCH
/v1/instances/:instance_id/scripts/:script_id

Updates an existing script's metadata and/or node graph. Only specified fields are updated; others remain unchanged. Use update_nodes/update_edges flags to explicitly set empty lists.

Authorization

AuthorizationBearer <token>

Preferred API authentication. Use a JWT with the api audience.

In: header

Path Parameters

instance_id*string

The instance containing the script. Format: UUID string.

Formatuuid
script_id*string

The ID of the script to update. Format: UUID string.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

Updated name for the script. If not set, the name remains unchanged.

description?string

Updated description for the script. If not set, the description remains unchanged.

nodes.id*string
nodes.type*string
nodes.position.x*number
Formatdouble
nodes.position.y*number
Formatdouble
nodes.data?array<>
nodes.muted*boolean
nodes.collapsed*boolean
nodes.width?number
Formatdouble
nodes.height?number
Formatdouble
nodes.contained_nodes?array<string>
nodes.label?string
nodes.resolved_type?
nodes.parent_frame_id*string
edges.id*string
edges.source*string
edges.source_handle*string
edges.target*string
edges.target_handle*string
edges.edge_type*
update_nodes*boolean

Whether the nodes field should be updated (allows setting to empty list).

update_edges*boolean

Whether the edges field should be updated (allows setting to empty list).

paused?boolean

Updated paused setting. If not set, the paused setting remains unchanged. If set to false and script was paused, the script will be restarted.

quotas.max_execution_count?integer

Maximum number of node executions per trigger invocation.

Formatint64
quotas.max_execution_time_ms?integer

Maximum wall-clock time for a single trigger execution in milliseconds.

Formatint64
quotas.max_concurrent_triggers?integer

Maximum number of concurrent trigger invocations.

Formatint32
quotas.max_state_store_entries?integer

Maximum number of entries in the script's state store.

Formatint64
quotas.disable_timeouts*boolean

When true, disables per-node and data edge timeouts entirely.

update_quotas*boolean

Whether the quotas field should be updated (allows clearing quotas).

Response Body

application/json

application/json

application/json

application/json

curl -X PATCH "http://127.0.0.1:38765/v1/instances/:instance_id/scripts/:script_id" \  -H "Content-Type: application/json" \  -d '{    "nodes.id": "string",    "nodes.type": "string",    "nodes.position.x": 0.1,    "nodes.position.y": 0.1,    "nodes.muted": true,    "nodes.collapsed": true,    "nodes.parent_frame_id": "string",    "edges.id": "string",    "edges.source": "string",    "edges.source_handle": "string",    "edges.target": "string",    "edges.target_handle": "string",    "edges.edge_type": {},    "update_nodes": true,    "update_edges": true,    "quotas.disable_timeouts": true,    "update_quotas": true  }'
{  "script": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "name": "string",    "description": "string",    "nodes": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "type": "string",        "position": {          "x": 0.1,          "y": 0.1        },        "data": {          "property1": {            "null_value": "NULL_VALUE",            "number_value": 0.1,            "string_value": "string",            "bool_value": true,            "struct_value": {              "fields": {                "property1": {                  "null_value": "NULL_VALUE",                  "number_value": 0.1,                  "string_value": "string",                  "bool_value": true,                  "struct_value": {                    "fields": {}                  },                  "list_value": {                    "values": [                      {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      }                    ]                  }                },                "property2": {                  "null_value": "NULL_VALUE",                  "number_value": 0.1,                  "string_value": "string",                  "bool_value": true,                  "struct_value": {                    "fields": {}                  },                  "list_value": {                    "values": [                      {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      }                    ]                  }                }              }            },            "list_value": {              "values": [                {                  "null_value": "NULL_VALUE",                  "number_value": 0.1,                  "string_value": "string",                  "bool_value": true,                  "struct_value": {                    "fields": {                      "property1": {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      },                      "property2": {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      }                    }                  },                  "list_value": {                    "values": []                  }                }              ]            }          },          "property2": {            "null_value": "NULL_VALUE",            "number_value": 0.1,            "string_value": "string",            "bool_value": true,            "struct_value": {              "fields": {                "property1": {                  "null_value": "NULL_VALUE",                  "number_value": 0.1,                  "string_value": "string",                  "bool_value": true,                  "struct_value": {                    "fields": {}                  },                  "list_value": {                    "values": [                      {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      }                    ]                  }                },                "property2": {                  "null_value": "NULL_VALUE",                  "number_value": 0.1,                  "string_value": "string",                  "bool_value": true,                  "struct_value": {                    "fields": {}                  },                  "list_value": {                    "values": [                      {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      }                    ]                  }                }              }            },            "list_value": {              "values": [                {                  "null_value": "NULL_VALUE",                  "number_value": 0.1,                  "string_value": "string",                  "bool_value": true,                  "struct_value": {                    "fields": {                      "property1": {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      },                      "property2": {                        "null_value": "NULL_VALUE",                        "number_value": 0.1,                        "string_value": "string",                        "bool_value": true,                        "struct_value": {                          "fields": {}                        },                        "list_value": {                          "values": []                        }                      }                    }                  },                  "list_value": {                    "values": []                  }                }              ]            }          }        },        "muted": true,        "collapsed": true,        "width": 0.1,        "height": 0.1,        "contained_nodes": [          "string"        ],        "label": "string",        "resolved_type": "PORT_TYPE_ANY",        "parent_frame_id": "string"      }    ],    "edges": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "source": "string",        "source_handle": "string",        "target": "string",        "target_handle": "string",        "edge_type": "EDGE_TYPE_EXECUTION"      }    ],    "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366",    "paused": true,    "quotas": {      "max_execution_count": 0,      "max_execution_time_ms": 0,      "max_concurrent_triggers": 0,      "max_state_store_entries": 0,      "disable_timeouts": true    }  },  "diagnostics": [    {      "node_id": "string",      "edge_id": "string",      "message": "string",      "severity": "DIAGNOSTIC_ERROR"    }  ]}

How is this page?