Edit the draft graph and block enablement in one write. Inspect skipped for failures; do not retry deferred edges. With atomic=true, skipped operations or dropped inputs return 409 (OPERATIONS_NOT_APPLIED) without saving. mintedBlockIds maps labels to generated IDs. Lint is advisory; dryRun=true validates without saving, auditing, or notifying. The live deployment is unchanged. Workspace API keys return 403; use a personal API key or scoped OAuth token.
OAuth scope: api:write.
/api/v2/workflows/{workflowId}/operationsYour Sim API key, personal or workspace-scoped. Generate one under Settings, then API Keys. Operations that reject workspace keys say so in their own description.
In: header
Path Parameters
Unique workflow identifier.
1 <= lengthQuery Parameters
Validate and lint without persisting. The response is identical to the committed write of the same body, so a caller can inspect lint and then re-send the request for real. Nothing is written, no audit entry is recorded, and collaborators are not notified.
Request Body
application/json
A batch of semantic edits against a workflow graph.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://www.sim.ai/api/v2/workflows/3b1f7c92-8d4e-4a6b-9c0d-5e2f8a714b36/operations" \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "operations": [ { "operation_type": "add", "block_id": "agent-1", "params": { "type": "agent", "name": "Triage", "inputs": { "tools": [ { "type": "cloudwatch", "operation": "describe_alarm_history", "usageControl": "auto", "params": {} } ] } } } ] }'{
"data": {
"id": "3b1f7c92-8d4e-4a6b-9c0d-5e2f8a714b36",
"applied": 1,
"skipped": [],
"deferred": [],
"inputValidationErrors": [],
"mintedBlockIds": {
"triage": "a3f1c0b2-7a44-4c1d-9d3a-2b8e5f0a1c77"
},
"lint": {
"sources": [],
"sinks": [],
"orphanBlocks": [],
"emptyOutgoingPorts": [],
"invalidBranchPorts": [],
"invalidConnectionTargets": [],
"fieldIssues": [
{
"blockId": "agent-1",
"blockName": "Triage",
"blockType": "agent",
"missingRequiredFields": [
"systemPrompt"
],
"inactiveModeValues": []
}
],
"unresolvedReferences": [],
"notes": []
},
"warnings": [],
"needsRedeployment": true,
"dryRun": false
}
}{
"error": {
"code": "BAD_REQUEST",
"message": "Invalid request"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Insufficient workspace permissions",
"details": {
"code": "INSUFFICIENT_WORKSPACE_ROLE"
}
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Not found"
}
}{
"error": {
"code": "CONFLICT",
"message": "Webhook path already in use"
}
}{
"error": {
"code": "PAYLOAD_TOO_LARGE",
"message": "Request body is too large"
}
}{
"error": {
"code": "UNSUPPORTED_MEDIA_TYPE",
"message": "Request body must be sent as application/json"
}
}{
"error": {
"code": "LOCKED",
"message": "Workflow is locked"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "API rate limit exceeded",
"details": {
"retryAfter": "2026-01-01T00:00:30.000Z"
}
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "Service temporarily unavailable"
}
}