Skip to main content
PATCH
/
agent-tasks
/
execution
/
{taskId}
/
user-input
Submit User Input
curl --request PATCH \
  --url https://api.beamstudio.ai/agent-tasks/execution/{taskId}/user-input \
  --header 'Content-Type: application/json' \
  --header 'current-workspace-id: <current-workspace-id>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "taskNodeId": "<string>",
  "userInputs": [
    {
      "question": "<string>",
      "answer": "<string>",
      "parameter": "<string>"
    }
  ]
}
'
{
  "id": "<string>",
  "agentGraphId": "<string>",
  "customId": "<string>",
  "tokensUsed": 123,
  "totalCost": 123,
  "taskSummary": "<string>",
  "taskObjective": "<string>",
  "graphState": {},
  "isViewed": true,
  "canRerunTaskNode": true,
  "status": "QUEUED",
  "averageEvaluationScore": 123,
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "agentTaskNodes": [
    {
      "id": "<string>",
      "agentGraphNodeId": "<string>",
      "status": "QUEUED",
      "retriedCountWhenFailure": 123,
      "retriedCountWhenAccuracyIsLow": 123,
      "manualRetryCount": 123,
      "isEverConsentRequired": true,
      "agentGraphNode": {
        "id": "<string>",
        "customId": "<string>",
        "objective": "<string>",
        "evaluationCriteria": [
          "<string>"
        ],
        "isEntryNode": true,
        "isExitNode": true,
        "isEvaluationEnabled": true,
        "autoRetryWhenAccuracyLessThan": 123,
        "autoRetryLimitWhenAccuracyIsLow": 123,
        "enableAutoRetryWhenAccuracyIsLow": true,
        "enableAutoRetryWhenFailure": true,
        "autoRetryDescription": null,
        "enableAutoRetryDescription": false,
        "autoRetryCountWhenFailure": 123,
        "autoRetryWaitTimeWhenFailureInMs": 123,
        "isAttachmentDataPulledIn": true,
        "isEdited": true,
        "createdAt": "2023-11-07T05:31:56Z",
        "toolConfiguration": {
          "id": "<string>",
          "toolFunctionName": "<string>",
          "toolName": "<string>",
          "requiresConsent": true,
          "isMemoryTool": true,
          "isBackgroundTool": true,
          "isBatchExecutionEnabled": true,
          "inputParams": [
            {
              "id": "param-123e4567-e89b-12d3-a456-426614174000",
              "paramName": "customerId",
              "fillType": "ai_fill",
              "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "linkOutputParam": {
                "id": "param-123e4567-e89b-12d3-a456-426614174000",
                "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                "isArray": false,
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "paramName": "customerData",
                "position": 1,
                "paramDescription": "The customer data retrieved from the database.",
                "parentId": "<string>",
                "paramPath": "response.data.customer",
                "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                "dataType": "string",
                "typeOptions": {}
              },
              "linkedOutputParamRules": [
                {
                  "elementKey": "<string>",
                  "agentToolConfigurationInputParamsId": "<string>",
                  "operator": "equals",
                  "comparisonValueType": "static",
                  "id": "<string>",
                  "createdAt": "2023-11-07T05:31:56Z",
                  "updatedAt": "2023-11-07T05:31:56Z",
                  "comparisonValue": "<string>",
                  "nextRuleOperator": "AND"
                }
              ],
              "position": 1,
              "question": "What is the customer ID?",
              "linkParamOutputId": "<string>",
              "paramDescription": "The unique identifier for the customer record.",
              "paramTip": "Enter the 8-digit customer ID from their account.",
              "staticValue": "default_value",
              "required": true,
              "dataType": "string",
              "outputExample": "CUST-12345678",
              "reloadProps": false,
              "remoteOptions": false,
              "options": [
                {
                  "label": "<string>",
                  "value": "<string>"
                }
              ],
              "linkedParamRulePrompt": "<string>",
              "ruleConditionConfig": {
                "conditionType": "llm_based"
              }
            }
          ],
          "outputParams": [
            {
              "id": "param-123e4567-e89b-12d3-a456-426614174000",
              "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
              "isArray": false,
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "paramName": "customerData",
              "position": 1,
              "paramDescription": "The customer data retrieved from the database.",
              "parentId": "<string>",
              "paramPath": "response.data.customer",
              "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
              "dataType": "string",
              "typeOptions": {}
            }
          ],
          "iconSrc": "<string>",
          "description": "<string>",
          "memoryLookupInstruction": "<string>",
          "accuracyScore": 123,
          "integrationProviderId": "<string>",
          "dynamicPropsId": "<string>",
          "fallbackModels": "<string>",
          "code": "<string>",
          "codeLanguage": "<string>",
          "originalTool": {
            "toolName": "<string>",
            "toolFunctionName": "<string>",
            "allowWaiting": true,
            "iconSrc": "<string>",
            "type": "<string>",
            "prompt": "<string>",
            "description": "<string>",
            "preferredModel": "<string>",
            "meta": {},
            "integrationId": "<string>",
            "isIntegrationRequired": true,
            "isIntegrationConnected": true,
            "integration": {
              "systemIntegrationProvider": "<string>",
              "systemIntegrationIdentifier": "<string>",
              "customAuthParameters": {}
            },
            "inputParams": [
              {
                "paramName": "customerId",
                "fillType": "ai_fill",
                "position": 1,
                "question": "What is the customer ID?",
                "linkParams": {
                  "toolId": "<string>",
                  "toolFunctionName": "<string>",
                  "outputParam": "<string>",
                  "outputId": "<string>"
                },
                "linkParamOutputId": "<string>",
                "paramDescription": "The unique identifier for the customer record.",
                "paramTip": "Enter the 8-digit customer ID from their account.",
                "staticValue": "default_value",
                "required": true,
                "dataType": "string",
                "isArray": false,
                "typeOptions": {},
                "outputExample": "CUST-12345678",
                "reloadProps": false,
                "remoteOptions": false,
                "options": [
                  {
                    "label": "<string>",
                    "value": "<string>"
                  }
                ],
                "linkedOutputParamRulesData": {
                  "linkedParamConfigurations": {
                    "conditionType": "llm_based"
                  },
                  "rules": [
                    {
                      "elementKey": "<string>",
                      "operator": "equals",
                      "comparisonValueType": "static",
                      "comparisonValue": "<string>",
                      "nextRuleOperator": "AND"
                    }
                  ],
                  "linkedParamRulePrompt": "<string>"
                }
              }
            ],
            "outputParams": [
              {
                "position": 123,
                "paramName": "<string>",
                "paramDescription": "<string>",
                "id": "<string>",
                "agentToolConfigurationId": "<string>",
                "dataType": "string",
                "isArray": true,
                "typeOptions": {},
                "parentId": "<string>",
                "paramPath": "<string>",
                "outputExample": "<string>"
              }
            ]
          },
          "preferredModel": "<string>"
        },
        "childEdges": [
          {
            "id": "<string>",
            "sourceAgentGraphNodeId": "<string>",
            "targetAgentGraphNodeId": "<string>",
            "isAttachmentDataPulledIn": true,
            "conditionGroups": [
              {
                "agentGraphEdgeId": "<string>",
                "edge": {
                  "sourceAgentGraphNodeId": "<string>",
                  "targetAgentGraphNodeId": "<string>",
                  "isAttachmentDataPulledIn": true,
                  "conditionGroups": "<array>",
                  "id": "<string>",
                  "createdAt": "2023-11-07T05:31:56Z",
                  "updatedAt": "2023-11-07T05:31:56Z",
                  "condition": "<string>"
                },
                "rules": [
                  {
                    "agentGraphEdgeConditionGroupId": "<string>",
                    "sourceAgentToolConfigurationOutputParamsId": "<string>",
                    "operator": "equals",
                    "comparisonValueType": "static",
                    "group": "<unknown>",
                    "sourceOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    },
                    "id": "<string>",
                    "createdAt": "2023-11-07T05:31:56Z",
                    "updatedAt": "2023-11-07T05:31:56Z",
                    "comparisonValue": "<string>",
                    "comparisonAgentToolConfigurationOutputParamsId": "<string>",
                    "nextRuleOperator": "AND",
                    "comparisonOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    }
                  }
                ],
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "nextGroupOperator": "AND"
              }
            ],
            "condition": "<string>"
          }
        ],
        "parentEdges": [
          {
            "id": "<string>",
            "sourceAgentGraphNodeId": "<string>",
            "targetAgentGraphNodeId": "<string>",
            "isAttachmentDataPulledIn": true,
            "conditionGroups": [
              {
                "agentGraphEdgeId": "<string>",
                "edge": {
                  "sourceAgentGraphNodeId": "<string>",
                  "targetAgentGraphNodeId": "<string>",
                  "isAttachmentDataPulledIn": true,
                  "conditionGroups": "<array>",
                  "id": "<string>",
                  "createdAt": "2023-11-07T05:31:56Z",
                  "updatedAt": "2023-11-07T05:31:56Z",
                  "condition": "<string>"
                },
                "rules": [
                  {
                    "agentGraphEdgeConditionGroupId": "<string>",
                    "sourceAgentToolConfigurationOutputParamsId": "<string>",
                    "operator": "equals",
                    "comparisonValueType": "static",
                    "group": "<unknown>",
                    "sourceOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    },
                    "id": "<string>",
                    "createdAt": "2023-11-07T05:31:56Z",
                    "updatedAt": "2023-11-07T05:31:56Z",
                    "comparisonValue": "<string>",
                    "comparisonAgentToolConfigurationOutputParamsId": "<string>",
                    "nextRuleOperator": "AND",
                    "comparisonOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    }
                  }
                ],
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "nextGroupOperator": "AND"
              }
            ],
            "condition": "<string>"
          }
        ],
        "xCoordinate": 123,
        "yCoordinate": 123,
        "onError": "CONTINUE",
        "nodeType": "executionNode",
        "nodeConfigurations": {
          "conditionType": "llm_based",
          "llmModel": "<string>",
          "fallbackModels": "<string>",
          "waitType": "time_based",
          "timeToWaitValue": 123,
          "timeToWaitUnit": "minutes",
          "linkedAgentGraphNodeId": "<string>",
          "rule": "<string>",
          "conditions": [
            {
              "operator": "AND",
              "conditions": [
                {
                  "condition": "is",
                  "operator": "AND",
                  "property": "<string>",
                  "value": "<string>"
                }
              ]
            }
          ],
          "timeoutType": "no_timeout",
          "timeoutValue": 123,
          "timeoutUnit": "minutes",
          "onTimeout": "continue"
        }
      },
      "edgeEvaluations": [
        {
          "target_node_id": "<string>",
          "eval_criteria": "<string>",
          "branch_name": "<string>",
          "reason": "<string>",
          "selected": true
        }
      ],
      "nodeEvaluation": [
        "<array>"
      ],
      "userFeedback": "<string>",
      "evaluationScore": 123,
      "userQuestions": [
        {
          "question": "<string>",
          "answer": "<string>",
          "parameter": "<string>",
          "memoryAnswer": true,
          "foodForThought": [
            {
              "question": "<string>",
              "answer": "<string>"
            }
          ]
        }
      ],
      "output": {
        "value": {}
      },
      "input": [
        {
          "id": "<string>",
          "name": "<string>",
          "value": "<string>",
          "question": "<string>",
          "reasoning": "<string>",
          "found": true,
          "required": true,
          "answer": "<string>"
        }
      ],
      "toolData": {
        "tool_id": "<string>",
        "tool_parameters": [
          {}
        ],
        "tool_output": [
          {}
        ],
        "required_parameters": {},
        "optional_parameters": {},
        "reasoning": {},
        "filled_prompt": "<string>",
        "skip_param_extraction": [
          "<string>"
        ],
        "integration_identifier": "<string>",
        "integration_error": false
      },
      "rating": "positive"
    }
  ],
  "contextFiles": [
    {
      "name": "<string>",
      "userId": "<string>",
      "uploadStatus": "processing",
      "uploadSource": "file_upload",
      "isForAgentDatabase": true,
      "agentId": "<string>",
      "agent": {
        "id": "agent-123e4567-e89b-12d3-a456-426614174000",
        "name": "Customer Support Agent",
        "creatorId": "<string>",
        "type": "beam-os",
        "vectorDbId": "<string>",
        "creditUsage": 12.5,
        "order": 123,
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "description": "<string>",
        "settings": {
          "prompts": [
            "You are a helpful customer support agent.",
            "Always be polite and professional."
          ],
          "preferredModel": "gpt-4",
          "instructions": "Focus on providing concise answers."
        },
        "config": {
          "restrictions": "<string>",
          "taskTemplates": [
            {
              "id": "<string>",
              "objective": "<string>",
              "description": "<string>",
              "steps": [
                {
                  "step": "<string>",
                  "toolId": "<string>",
                  "iconSrc": "<string>",
                  "iconUrl": "<string>",
                  "beamTool": true,
                  "gptTool": true,
                  "consentRequired": true,
                  "integrationId": "<string>",
                  "isIntegrationRequired": true,
                  "isIntegrationConnected": true,
                  "integrationProvider": "<string>",
                  "integrationIdentifier": "<string>",
                  "toolDetail": {},
                  "integrationCustomAuthParameters": {}
                }
              ],
              "default": true,
              "category": {
                "id": "<string>",
                "title": "<string>"
              },
              "lastUpdatedAt": "2023-11-07T05:31:56Z"
            }
          ],
          "tools": [
            "<string>"
          ],
          "llmTools": [
            {}
          ],
          "sop": {},
          "defaultTaskId": "<string>",
          "workspaceId": "<string>"
        },
        "workspaceId": "<string>",
        "defaultTaskId": "<string>",
        "themeIconUrl": "https://example.com/icons/support-agent.png",
        "agentCategoryId": "<string>",
        "userAccessTokenId": "<string>",
        "agentSetupSessionId": "<string>",
        "agentIntroMessage": "<string>",
        "agentSetupMessage": "<string>",
        "skipAgentSetupSop": true,
        "isAttachmentDataPulledIn": true
      },
      "user": {
        "name": "John Doe",
        "email": "<string>",
        "cognitoUserId": "<string>",
        "role_name": "<string>",
        "isInternalUser": true,
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "avatarSrc": "https://example.com/avatars/user123.png",
        "socialProvider": "<string>",
        "socialProviderId": "<string>",
        "password": "<string>",
        "paymentProviderCustomerId": "<string>",
        "rememberToken": "<string>",
        "emailVerified": true,
        "referralCode": "<string>"
      },
      "agentTask": {
        "agentGraphId": "graph-123e4567-e89b-12d3-a456-426614174000",
        "manualRetryCount": 0,
        "isSuccess": false,
        "isViewed": false,
        "canRerunTaskNode": true,
        "mode": "AUTO",
        "status": "QUEUED",
        "taskReceiveAt": 123,
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "customId": "TASK-2024-001",
        "originalTaskQuery": "Generate a quarterly sales report for Q4 2024",
        "taskObjective": "Analyze sales data and create comprehensive report",
        "taskInstructions": "Include revenue breakdown by region and product category",
        "taskContext": {},
        "taskSuccessCriteria": "Report must include all regions and be formatted as PDF",
        "taskQuery": "Generate sales report for Q4 2024 with regional breakdown",
        "taskSummary": "Successfully generated Q4 sales report with 15 pages",
        "initiationDetail": {},
        "triggerRecordId": "msg-abc123",
        "startedAt": "2024-01-15T10:00:00Z",
        "endedAt": "2024-01-15T10:05:30Z",
        "userFeedback": "The report was accurate and well-formatted",
        "rating": "positive",
        "averageEvaluationScore": 0.85,
        "taskState": {
          "nodeSelections": [
            {
              "edgeId": "<string>",
              "condition": "<string>",
              "selected": true,
              "reasoning": "<string>",
              "otherEdges": "<array>"
            }
          ]
        },
        "graphState": {},
        "totalExecutionTime": 330.5,
        "tokensUsed": 15000,
        "totalCost": 0.0225,
        "tokenUsages": [
          {
            "agentTaskId": "<string>",
            "agentGraphNodeId": "<string>",
            "creditTransactionId": "<string>",
            "promptSlug": "<string>",
            "executionStage": "QUERY_REFORMULATION",
            "iteration": 123,
            "model": "<string>",
            "operation": "NORMAL",
            "inputToken": 123,
            "outputToken": 123,
            "reasoningToken": 123,
            "totalToken": 123,
            "isLatest": true,
            "agentTask": "<unknown>",
            "id": "<string>",
            "createdAt": "2023-11-07T05:31:56Z",
            "updatedAt": "2023-11-07T05:31:56Z"
          }
        ]
      },
      "id": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "src": "<string>",
      "fileKey": "<string>",
      "mimeType": "<string>",
      "taskId": "<string>",
      "agentTaskId": "<string>",
      "url": "<string>",
      "datasourceConnectionId": "<string>",
      "externalFileId": "<string>"
    }
  ],
  "agentGraph": {
    "id": "<string>",
    "agentId": "<string>",
    "isActive": true,
    "isDraft": true,
    "isPublished": true,
    "isEdited": true,
    "isEverExecuted": true,
    "isEverUsedForTemplate": true,
    "nodes": [
      {
        "id": "<string>",
        "customId": "<string>",
        "objective": "<string>",
        "evaluationCriteria": [
          "<string>"
        ],
        "isEntryNode": true,
        "isExitNode": true,
        "isEvaluationEnabled": true,
        "autoRetryWhenAccuracyLessThan": 123,
        "autoRetryLimitWhenAccuracyIsLow": 123,
        "enableAutoRetryWhenAccuracyIsLow": true,
        "enableAutoRetryWhenFailure": true,
        "autoRetryDescription": null,
        "enableAutoRetryDescription": false,
        "autoRetryCountWhenFailure": 123,
        "autoRetryWaitTimeWhenFailureInMs": 123,
        "isAttachmentDataPulledIn": true,
        "isEdited": true,
        "createdAt": "2023-11-07T05:31:56Z",
        "toolConfiguration": {
          "id": "<string>",
          "toolFunctionName": "<string>",
          "toolName": "<string>",
          "requiresConsent": true,
          "isMemoryTool": true,
          "isBackgroundTool": true,
          "isBatchExecutionEnabled": true,
          "inputParams": [
            {
              "id": "param-123e4567-e89b-12d3-a456-426614174000",
              "paramName": "customerId",
              "fillType": "ai_fill",
              "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "linkOutputParam": {
                "id": "param-123e4567-e89b-12d3-a456-426614174000",
                "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                "isArray": false,
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "paramName": "customerData",
                "position": 1,
                "paramDescription": "The customer data retrieved from the database.",
                "parentId": "<string>",
                "paramPath": "response.data.customer",
                "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                "dataType": "string",
                "typeOptions": {}
              },
              "linkedOutputParamRules": [
                {
                  "elementKey": "<string>",
                  "agentToolConfigurationInputParamsId": "<string>",
                  "operator": "equals",
                  "comparisonValueType": "static",
                  "id": "<string>",
                  "createdAt": "2023-11-07T05:31:56Z",
                  "updatedAt": "2023-11-07T05:31:56Z",
                  "comparisonValue": "<string>",
                  "nextRuleOperator": "AND"
                }
              ],
              "position": 1,
              "question": "What is the customer ID?",
              "linkParamOutputId": "<string>",
              "paramDescription": "The unique identifier for the customer record.",
              "paramTip": "Enter the 8-digit customer ID from their account.",
              "staticValue": "default_value",
              "required": true,
              "dataType": "string",
              "outputExample": "CUST-12345678",
              "reloadProps": false,
              "remoteOptions": false,
              "options": [
                {
                  "label": "<string>",
                  "value": "<string>"
                }
              ],
              "linkedParamRulePrompt": "<string>",
              "ruleConditionConfig": {
                "conditionType": "llm_based"
              }
            }
          ],
          "outputParams": [
            {
              "id": "param-123e4567-e89b-12d3-a456-426614174000",
              "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
              "isArray": false,
              "createdAt": "2023-11-07T05:31:56Z",
              "updatedAt": "2023-11-07T05:31:56Z",
              "paramName": "customerData",
              "position": 1,
              "paramDescription": "The customer data retrieved from the database.",
              "parentId": "<string>",
              "paramPath": "response.data.customer",
              "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
              "dataType": "string",
              "typeOptions": {}
            }
          ],
          "iconSrc": "<string>",
          "description": "<string>",
          "memoryLookupInstruction": "<string>",
          "accuracyScore": 123,
          "integrationProviderId": "<string>",
          "dynamicPropsId": "<string>",
          "fallbackModels": "<string>",
          "code": "<string>",
          "codeLanguage": "<string>",
          "originalTool": {
            "toolName": "<string>",
            "toolFunctionName": "<string>",
            "allowWaiting": true,
            "iconSrc": "<string>",
            "type": "<string>",
            "prompt": "<string>",
            "description": "<string>",
            "preferredModel": "<string>",
            "meta": {},
            "integrationId": "<string>",
            "isIntegrationRequired": true,
            "isIntegrationConnected": true,
            "integration": {
              "systemIntegrationProvider": "<string>",
              "systemIntegrationIdentifier": "<string>",
              "customAuthParameters": {}
            },
            "inputParams": [
              {
                "paramName": "customerId",
                "fillType": "ai_fill",
                "position": 1,
                "question": "What is the customer ID?",
                "linkParams": {
                  "toolId": "<string>",
                  "toolFunctionName": "<string>",
                  "outputParam": "<string>",
                  "outputId": "<string>"
                },
                "linkParamOutputId": "<string>",
                "paramDescription": "The unique identifier for the customer record.",
                "paramTip": "Enter the 8-digit customer ID from their account.",
                "staticValue": "default_value",
                "required": true,
                "dataType": "string",
                "isArray": false,
                "typeOptions": {},
                "outputExample": "CUST-12345678",
                "reloadProps": false,
                "remoteOptions": false,
                "options": [
                  {
                    "label": "<string>",
                    "value": "<string>"
                  }
                ],
                "linkedOutputParamRulesData": {
                  "linkedParamConfigurations": {
                    "conditionType": "llm_based"
                  },
                  "rules": [
                    {
                      "elementKey": "<string>",
                      "operator": "equals",
                      "comparisonValueType": "static",
                      "comparisonValue": "<string>",
                      "nextRuleOperator": "AND"
                    }
                  ],
                  "linkedParamRulePrompt": "<string>"
                }
              }
            ],
            "outputParams": [
              {
                "position": 123,
                "paramName": "<string>",
                "paramDescription": "<string>",
                "id": "<string>",
                "agentToolConfigurationId": "<string>",
                "dataType": "string",
                "isArray": true,
                "typeOptions": {},
                "parentId": "<string>",
                "paramPath": "<string>",
                "outputExample": "<string>"
              }
            ]
          },
          "preferredModel": "<string>"
        },
        "childEdges": [
          {
            "id": "<string>",
            "sourceAgentGraphNodeId": "<string>",
            "targetAgentGraphNodeId": "<string>",
            "isAttachmentDataPulledIn": true,
            "conditionGroups": [
              {
                "agentGraphEdgeId": "<string>",
                "edge": {
                  "sourceAgentGraphNodeId": "<string>",
                  "targetAgentGraphNodeId": "<string>",
                  "isAttachmentDataPulledIn": true,
                  "conditionGroups": "<array>",
                  "id": "<string>",
                  "createdAt": "2023-11-07T05:31:56Z",
                  "updatedAt": "2023-11-07T05:31:56Z",
                  "condition": "<string>"
                },
                "rules": [
                  {
                    "agentGraphEdgeConditionGroupId": "<string>",
                    "sourceAgentToolConfigurationOutputParamsId": "<string>",
                    "operator": "equals",
                    "comparisonValueType": "static",
                    "group": "<unknown>",
                    "sourceOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    },
                    "id": "<string>",
                    "createdAt": "2023-11-07T05:31:56Z",
                    "updatedAt": "2023-11-07T05:31:56Z",
                    "comparisonValue": "<string>",
                    "comparisonAgentToolConfigurationOutputParamsId": "<string>",
                    "nextRuleOperator": "AND",
                    "comparisonOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    }
                  }
                ],
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "nextGroupOperator": "AND"
              }
            ],
            "condition": "<string>"
          }
        ],
        "parentEdges": [
          {
            "id": "<string>",
            "sourceAgentGraphNodeId": "<string>",
            "targetAgentGraphNodeId": "<string>",
            "isAttachmentDataPulledIn": true,
            "conditionGroups": [
              {
                "agentGraphEdgeId": "<string>",
                "edge": {
                  "sourceAgentGraphNodeId": "<string>",
                  "targetAgentGraphNodeId": "<string>",
                  "isAttachmentDataPulledIn": true,
                  "conditionGroups": "<array>",
                  "id": "<string>",
                  "createdAt": "2023-11-07T05:31:56Z",
                  "updatedAt": "2023-11-07T05:31:56Z",
                  "condition": "<string>"
                },
                "rules": [
                  {
                    "agentGraphEdgeConditionGroupId": "<string>",
                    "sourceAgentToolConfigurationOutputParamsId": "<string>",
                    "operator": "equals",
                    "comparisonValueType": "static",
                    "group": "<unknown>",
                    "sourceOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    },
                    "id": "<string>",
                    "createdAt": "2023-11-07T05:31:56Z",
                    "updatedAt": "2023-11-07T05:31:56Z",
                    "comparisonValue": "<string>",
                    "comparisonAgentToolConfigurationOutputParamsId": "<string>",
                    "nextRuleOperator": "AND",
                    "comparisonOutputParam": {
                      "id": "param-123e4567-e89b-12d3-a456-426614174000",
                      "agentToolConfigurationId": "config-123e4567-e89b-12d3-a456-426614174000",
                      "isArray": false,
                      "createdAt": "2023-11-07T05:31:56Z",
                      "updatedAt": "2023-11-07T05:31:56Z",
                      "paramName": "customerData",
                      "position": 1,
                      "paramDescription": "The customer data retrieved from the database.",
                      "parentId": "<string>",
                      "paramPath": "response.data.customer",
                      "outputExample": "{\"name\": \"John Doe\", \"email\": \"john@example.com\"}",
                      "dataType": "string",
                      "typeOptions": {}
                    }
                  }
                ],
                "id": "<string>",
                "createdAt": "2023-11-07T05:31:56Z",
                "updatedAt": "2023-11-07T05:31:56Z",
                "nextGroupOperator": "AND"
              }
            ],
            "condition": "<string>"
          }
        ],
        "xCoordinate": 123,
        "yCoordinate": 123,
        "onError": "CONTINUE",
        "nodeType": "executionNode",
        "nodeConfigurations": {
          "conditionType": "llm_based",
          "llmModel": "<string>",
          "fallbackModels": "<string>",
          "waitType": "time_based",
          "timeToWaitValue": 123,
          "timeToWaitUnit": "minutes",
          "linkedAgentGraphNodeId": "<string>",
          "rule": "<string>",
          "conditions": [
            {
              "operator": "AND",
              "conditions": [
                {
                  "condition": "is",
                  "operator": "AND",
                  "property": "<string>",
                  "value": "<string>"
                }
              ]
            }
          ],
          "timeoutType": "no_timeout",
          "timeoutValue": 123,
          "timeoutUnit": "minutes",
          "onTimeout": "continue"
        }
      }
    ],
    "agent": {
      "id": "<string>",
      "name": "<string>",
      "type": "beam-os",
      "creatorId": "<string>",
      "order": 123,
      "description": "<string>",
      "themeIconUrl": "<string>",
      "agentCategoryId": "<string>",
      "category": {
        "id": "<string>",
        "title": "<string>"
      },
      "workspaceId": "<string>"
    },
    "publishedAt": {}
  },
  "initiationDetail": {},
  "originalTaskQuery": "<string>",
  "taskQuery": "<string>",
  "taskState": {
    "nodeSelections": [
      {
        "edgeId": "<string>",
        "condition": "<string>",
        "selected": true,
        "reasoning": "<string>",
        "otherEdges": "<array>"
      }
    ]
  },
  "userFeedback": "<string>",
  "rating": "positive",
  "creditTransactions": [
    {
      "id": "<string>",
      "transactionType": "subscription_purchase",
      "creditsAmount": 123,
      "tokensUsed": 123,
      "costAmount": 123,
      "usageCategory": "<string>",
      "agentGraphNodeId": "<string>",
      "toolType": "<string>",
      "modelName": "<string>"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Headers

current-workspace-id
string
required

Path Parameters

taskId
string
required

Body

application/json
taskNodeId
string
required
userInputs
object[]
required

Response

200 - application/json

User input submitted successfully

id
string
required
agentGraphId
string
required
customId
string
required
tokensUsed
number
required
totalCost
number
required
taskSummary
string | null
required
taskObjective
string
required
graphState
object
required
isViewed
boolean
required
canRerunTaskNode
boolean
required
status
enum<string>
required
Available options:
QUEUED,
IN_PROGRESS,
COMPLETED,
FAILED,
USER_INPUT_REQUIRED,
USER_CONSENT_REQUIRED,
STOPPED,
AUTHENTICATION_REQUIRED,
INSUFFICIENT_CREDITS,
WAITING
averageEvaluationScore
number | null
required
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
agentTaskNodes
object[]
required
contextFiles
object[]
required
agentGraph
object
required
initiationDetail
object
required
originalTaskQuery
string | null
taskQuery
string | null
taskState
object
userFeedback
string
rating
enum<string>
Available options:
positive,
negative
creditTransactions
object[]