aiAgentUpdate

Updated 19 October 2026

Update an existing AI Agent in the AI Agent Registry.

Description: This mutation updates the AI Agent associated with the authenticated user’s account. The agent to update is identified by id.

Note: the metadata field is named metadata on AiAgentCreateInput but metaData on AiAgentUpdateInput. This casing difference is intentional, not a typo — use the exact field name shown for each mutation.

Input Parameters (AiAgentUpdateInput):

• id: ID! - Required. Unique identifier of the internal AI agent to be updated
• agentName: String - Optional. Name of the AI agent.
• agentDescription: String - Optional. Description of the AI agent.
• tags: Array of type AiAgentTagInput - Optional
• trustLevel: AiAgentRegistryTrustLevel - Optional. Confidence and reliability level of the AI agent.
• metaData: String - Optional. Metadata for the agent in JSON format

Response:

• Returns the updated AiAgent object.

Example Request:

mutation UpdateAiAgent {
  aiAgentUpdate(input: {
    id: "37b35a1c-10d9-4be3-b5b9-604eb62f99f4",
    agentName: "Alpha Updated",
    agentDescription: "Updated description of the AI agent",
    tags: [
      {
        key: "priority",
        value: "urgent"
      }
    ],
    trustLevel: ENDORSED,
    metaData: "{ \"department\": \"support\" }"
  }) {
    id
    externalId
    createdByOrigin
    agentVersions {
      id
      externalId
      version
      name
      description
      agentStatus
      versionMetadata
      tags {
        id
        key
        value
      }
      llms {
        id
        name
        description
        version
      }
      syncData {
        lastSyncStatus
        lastSyncStartDate
        lastSyncEndDate
      }
      auditData {
        createdByUserId
        createdTime
        modifiedByUserId
        modifiedTime
        createdByOrigin
        updatedByOrigin
        updatedAtProviderTime
      }
    }
  }
}

Example Response (success):

{
    "data": {
        "aiAgentUpdate": {
            "id": "37b35a1c-10d9-4be3-b5b9-604eb62f99f4",
            "externalId": "ext-agent-alpha-001",
            "createdByOrigin": "REGISTRY",
            "agentVersions": [
                {
                    "id": "e7fabdf1-b88e-4b3f-b0fd-eacb332073f5",
                    "externalId": null,
                    "version": "DRAFT",
                    "name": "Alpha Updated",
                    "description": "Updated description of the AI agent",
                    "agentStatus": "PREPARING",
                    "versionMetadata": null,
                    "tags": [
                        { "id": "6f9fe561-2381-488a-92ca-0b79f1c52316", "key": "priority", "value": "urgent" }
                    ],
                    "llms": [],
                    "syncData": null,
                    "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
                    }
                }
            ]
        }
    }
}

aiAgentUpdate(
  input: AiAgentUpdateInput!
): AiAgent

Arguments

aiAgentUpdate.input ● AiAgentUpdateInput! non-null input agent-control-tower {#input}

Type

AiAgent object agent-control-tower