aiAgentAliasUpdate

Updated 19 October 2026

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

Description: This mutation updates an existing AI Agent Alias associated with the authenticated user's account.

Input Parameters (AiAgentAliasUpdateInput):

• id: ID! - Required. The unique identifier of the AI Agent Alias to be updated.
• name: String - Optional. Name of the AI Agent Alias.
• description: String - Optional. Description of the AI Agent Alias.
• trustLevel: AiAgentRegistryTrustLevel - Optional. Indicates the confidence and reliability level of the AI Agent Alias.
• agentStatus: AgentStatus - Optional. Status of the AI Agent Alias. Accepted values are ACTIVE or INACTIVE.
• tags: [AiAgentTagInput!] - Optional. Tags for classification and organization of the AI Agent Alias.

Response:

• Returns the updated AiAgentAlias object.

Example Request:

mutation UpdateAiAgentAlias {
    aiAgentAliasUpdate(input: {
        id: "24d08f7b-a14f-405e-9ba4-e2e2b3f2215b",
        name: "Updated Production Alias",
        description: "Updated production alias for customer support agent",
        trustLevel: ENDORSED,
        agentStatus: ACTIVE,
        tags: [{ key: "env", value: "production" }]
    }) {
        id
        name
        description
        externalId
        trustLevel
        isDeleted
        agentStatus
        agentVersion {
            id
            version
            name
        }
        invocationSpecs {
            protocol
            spec
        }
        tags {
            id
            key
            value
        }
        auditData {
            createdByUserId
            createdTime
            createdByOrigin
            modifiedByUserId
            modifiedTime
        }
    }
}

Example Response (success):

{
    "data": {
        "aiAgentAliasUpdate": {
            "id": "adafc48d-ca0b-4087-8aeb-29568bdd78e4",
            "name": "Updated Production Alias",
            "description": "Updated production alias for customer support agent",
            "externalId": "ext-alias-prod-001",
            "trustLevel": "ENDORSED",
            "isDeleted": false,
            "agentStatus": "ACTIVE",
            "agentVersion": {
                "id": "e7fabdf1-b88e-4b3f-b0fd-eacb332073f5",
                "version": "1",
                "name": "Alpha"
            },
            "invocationSpecs": [],
            "tags": [
                { "id": "6f9fe561-2381-488a-92ca-0b79f1c52316", "key": "env", "value": "production" }
            ],
            "auditData": {
                "createdByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "createdTime": "2026-09-17T10:00:00Z",
                "createdByOrigin": "REGISTRY",
                "modifiedByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "modifiedTime": "2026-09-17T10:05:00Z"
            }
        }
    }
}

aiAgentAliasUpdate(
  input: AiAgentAliasUpdateInput!
): AiAgentAlias!

Arguments

aiAgentAliasUpdate.input ● AiAgentAliasUpdateInput! non-null input agent-control-tower {#input}

Type

AiAgentAlias object agent-control-tower