Waiting for engine...
Skip to main content

aiAgentTaskUpdate

Updated 

Update an existing AI Agent Task in the AI Agent Registry.

Description: This mutation updates an existing AI Agent Task associated with the authenticated user's account. This agent version association is an incremental operation. If an association already exists, it is skipped; otherwise, the task is linked to the newer agent DRAFT version.

When a Task is created, it's initially associated with an agent, for example, with GUID <xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx>. Upon updating the Task, this existing agent GUID is retained, and the Task is also associated with a new agent, such as <xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx>.

The response demonstrates this incremental association, showing both the previously existing and the newly associated agent versions.

Input Parameters (AiAgentTaskUpdateInput):

  • id: ID! - Required. ID of the AI Agent Task to be updated.
  • name: String - Optional. Name of the AI agent task.
  • description: String - Optional. Description of the AI agent task.
  • taskStatus: AiAgentTaskStatus - Optional. Status of the task.
  • taskMetaData: String - Optional. Additional task information in JSON format.
  • agentToolIds: [ID!] - Optional. List of AI Agent Tool IDs associated with this task.
  • tags: [AiAgentTagInput!] - Optional. Tags for categorization.
  • agentIds: [ID!] - Optional. List of AI Agent IDs to associate with this task. This will associate to DRAFT version of those agents.

Response:

  • Returns the updated AiAgentTask object.

Example Request:

mutation UpdateAiAgentTask {
    aiAgentTaskUpdate(input: {
        id: "c5839cd7-4936-4c83-8d14-bb2aa12b6cda",
        name: "Updated Data Processing Task",
        description: "Updated task for processing data inputs for AI agents.",
        taskStatus: RUNNING,
        taskMetaData: "{ \"priority\": \"medium\", \"category\": \"data-processing\" }",
        agentIds: ["8d61bc80-c097-4e78-9e7c-6d01d6e7ad8c", "861dfdf2-9cf5-48a8-b580-88899e38ed5a"],
        agentToolIds: ["ea0872f6-0981-4655-9bbb-20015d0b99af", "8a78e1ba-1855-4a7f-a1fa-2c2c7140a635"],
        tags: [{
            key: "category"
            value: "updated-data-processing"
        }]
    }) {
        id
        externalId
        name
        description
        version
        taskStatus
        metaData
        agentVersions {
            id
            name
            version
        }
        tools {
            id
            name
            description
        }
        tags {
            id
            key
            value
        }
        auditData {
            createdByUserId
            createdTime
            modifiedByUserId
            modifiedTime
            createdByOrigin
            updatedByOrigin
            updatedAtProviderTime
        }
    }
}

Example Response (success):


{
    "data": {
        "aiAgentTaskUpdate": {
            "id": "c5839cd7-4936-4c83-8d14-bb2aa12b6cda",
            "externalId": null,
            "name": "Updated Data Processing Task",
            "description": "Updated task for processing data inputs for AI agents.",
            "version": "DRAFT",
            "taskStatus": "RUNNING",
            "metaData": "{ \"priority\": \"medium\", \"category\": \"data-processing\" }",
            "agentVersions": [
                { "id": "05667da1-763b-45cf-99fb-4d94cd6977cc", "name": "Alpha", "version": "DRAFT" },
                { "id": "fba92cf8-abce-4acf-a9f7-9da938b0c513", "name": "Beta", "version": "DRAFT" }
            ],
            "tools": [
                { "id": "ea0872f6-0981-4655-9bbb-20015d0b99af", "name": "Customer Data Analyzer", "description": "Analyzes customer data" },
                { "id": "8a78e1ba-1855-4a7f-a1fa-2c2c7140a635", "name": "Data Visualizer", "description": "Generates data visualizations" }
            ],
            "tags": [
                { "id": "6f9fe561-2381-488a-92ca-0b79f1c52316", "key": "category", "value": "updated-data-processing" }
            ],
            "auditData": {
                "createdByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "createdTime": "2026-09-17T10:00:00Z",
                "modifiedByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "modifiedTime": "2026-09-17T10:05:00Z",
                "createdByOrigin": "REGISTRY",
                "updatedByOrigin": "REGISTRY",
                "updatedAtProviderTime": null
            }
        }
    }
}

aiAgentTaskUpdate(
  input: AiAgentTaskUpdateInput!
): AiAgentTask

Arguments​

aiAgentTaskUpdate.input ● AiAgentTaskUpdateInput! non-null input agent-control-tower {#input}

Type​

AiAgentTask object agent-control-tower

On this Page