Waiting for engine...
Skip to main content

aiAgentAliasCreate

Updated 

Create a new AI Agent Alias in the AI Agent Registry.

Description: This mutation creates a new alias for an AI Agent against an existing published version or a newly published version from the draft. An alias provides an alternative reference to an agent version, allowing for easier management and routing.

Input Parameters (AiAgentAliasCreateInput):

  • agentId: ID! - Required. The unique identifier of the AI Agent to which the alias will be associated.
  • agentVersionId: ID - Optional. The unique identifier of the AI Agent Version. If provided, the alias will be created for this existing published version. If not provided, a new version will be published from the current draft and the alias will be associated to it.
  • name: String! - Required. Name of the AI Agent Alias.
  • description: String - Optional. Description of the AI Agent Alias.
  • externalId: ID - Optional. External identifier for the AI Agent Alias in the provider system.
  • trustLevel: AiAgentRegistryTrustLevel - Optional. Indicates the confidence and reliability level of the AI Agent Alias.
  • tags: [AiAgentTagInput!] - Optional. Tags for classification and organization. If not provided, tags will be empty.

Response:

  • Returns the newly created AiAgentAlias object.

Example Request:

mutation CreateAiAgentAlias {
    aiAgentAliasCreate(input: {
        agentId: "f354c642-b8fd-4626-9777-2b03f772356d",
        agentVersionId: "ed899b0f-bc1f-4345-abe6-39297aa81cbc",
        name: "Production Alias",
        description: "Production alias for customer support agent",
        externalId: "ext-alias-prod-001",
        trustLevel: ENDORSED,
        tags: [{ key: "env", value: "production" }]
    }) {
        id
        name
        description
        externalId
        trustLevel
        agentStatus
        agentVersion {
            id
            version
            name
        }
        invocationSpecs {
            protocol
            spec
        }
        tags {
            id
            key
            value
        }
        auditData {
            createdByUserId
            createdTime
            createdByOrigin
            modifiedByUserId
            modifiedTime
        }
    }
}

Example Response (success):


{
    "data": {
        "aiAgentAliasCreate": {
            "id": "adafc48d-ca0b-4087-8aeb-29568bdd78e4",
            "name": "Production Alias",
            "description": "Production alias for customer support agent",
            "externalId": "ext-alias-prod-001",
            "trustLevel": "ENDORSED",
            "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:00:00Z"
            }
        }
    }
}

aiAgentAliasCreate(
  input: AiAgentAliasCreateInput!
): AiAgentAlias!

Arguments​

aiAgentAliasCreate.input ● AiAgentAliasCreateInput! non-null input agent-control-tower {#input}

Type​

AiAgentAlias object agent-control-tower

On this Page