Waiting for engine...
Skip to main content

aiAliasesDelete

Updated 

Delete multiple AI Agent aliases from the AI Agent Registry.

Description: This mutation removes multiple AI Agent aliases in a single operation. For each agent, you can specify which alias IDs to delete. At least one agent entry must be provided. Partial deletion is not allowed: the operation either succeeds for the entire input (and returns counts) or fails with a GraphQL Error and no entities are deleted.

Implementation logic For each agent in aiAgentsWithAliases, for each alias to delete (the given aliasIds), apply the same rules as aiAliasDelete:

  1. If the alias is DRAFT (TestAlias): delete the entire agent (and its versions and remaining aliases).
  2. If the alias is non-DRAFT: delete the alias only.
  3. If after an alias deletion the associated version has no remaining aliases: delete that version. The entire operation runs in a single transaction. On success, return the counts (aliasesDeleted required, agentsDeleted optional). On any failure, roll back and return a GraphQL Error; no partial deletion is performed.

Input Parameters (AiAliasesDeleteInput):

  • aiAgentsWithAliases: [AgentWithAliasesInput!]! - Required. Array of agents with their aliases to delete. Must contain at least one entry.

Agent Input Parameters (AgentWithAliasesInput):

  • agentId: ID! - Required. The unique identifier of the AI Agent whose aliases are to be deleted.
  • aliasIds: [ID!]! - Required. Array of alias IDs to delete.

Response (AiAliasesDeleteResult):

  • On success: returns aliasesDeleted (Int!, primary count) and agentsDeleted (Int!).
  • On failure: a GraphQL Error is returned and no partial deletion is performed.

Example Request:

mutation DeleteMultipleAiAliases {
    aiAliasesDelete(input: {
        aiAgentsWithAliases: [
            { agentId: "37b35a1c-10d9-4be3-b5b9-604eb62f99f4",
              aliasIds: ["adafc48d-ca0b-4087-8aeb-29568bdd78e4", "032972c3-a7b6-49ef-9aa0-b2306c3e06cb"]
            },
            { agentId: "4d9e7221-5cde-44dc-84f7-3175874e2725", aliasIds: ["3b771b67-96e8-48b4-8051-c4d82de1856c", "af59a816-48b5-47bb-8aee-031db3e9e14f"] }
        ]
    }) {
        aliasesDeleted
        agentsDeleted
    }
}

Example Response (success):


{
    "data": {
        "aiAliasesDelete": {
            "aliasesDeleted": 3,
            "agentsDeleted": 0
        }
    }
}

aiAliasesDelete(
  input: AiAliasesDeleteInput!
): AiAliasesDeleteResult!

Arguments​

aiAliasesDelete.input ● AiAliasesDeleteInput! non-null input agent-control-tower {#input}

Type​

AiAliasesDeleteResult object agent-control-tower

Result of deleting multiple AI Agent aliases. Returned on success; on failure a GraphQL Error is returned and no partial deletion occurs.

On this Page