aiAgentTaskUpdate

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: "task-123",
        name: "Updated Data Processing Task",
        description: "Updated task for processing data inputs for AI agents.",
        taskStatus: RUNNING,
        taskMetaData: "{ \"priority\": \"medium\", \"category\": \"data-processing\" }",
        agentIds: ["agent-guid-existing", "agent-guid-new"],
        agentToolIds: ["tool-guid-345", "tool-guid-678"],
        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
        }
    }
}

aiAgentTaskUpdate(
  input: AiAgentTaskUpdateInput!
): AiAgentTask

Arguments

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

Type

AiAgentTask object agent-control-tower