aiAgentTaskCreate

Updated 19 October 2026

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

Description: This mutation creates a new AI Agent Task with DRAFT version associated with the authenticated user's account. It also associates the task with any specified agents' DRAFT version.

Input Parameters (AiAgentTaskCreateInput):

• providerAccountId: ID! - Required. The unique identifier of the AI Agent Provider account where the task will be created.
• name: String! - Required. Name of the AI agent task.
• description: String - Optional. Description of the AI agent task.
• taskMetaData: String - Optional. Additional task information in JSON format.
• agentToolIds: [ID!] - Optional. List of AI Agent Tool IDs associate to this task.
• tags: [AiAgentTagInput!] - Optional. Tags for categorization.
• instructions: [String!] - Optional. Instructions for the task.
• 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 newly created AiAgentTask object.

Example Request:

mutation CreateAiAgentTask {
    aiAgentTaskCreate(input: {
        providerAccountId: "77196b85-9d08-4ee7-981f-65b45c11fd8b",
        name: "Summarize Customer Ticket",
        description: "Summarizes an inbound support ticket",
        instructions: ["Read the ticket body", "Produce a two-sentence summary"],
        taskMetaData: "{ \"category\": \"support\" }",
        agentToolIds: ["ff50061f-2bec-464e-afb3-8e7d9ea983a5"],
        agentIds: ["b9c2d731-750e-406c-a0f3-d9d6e98eee3a"],
        tags: [
            {
                key: "category"
                value: "support"
            }
        ]
    }) {
        id
        externalId
        name
        description
        instructions
        version
        taskStatus
        metaData
        agentVersions {
            id
            name
            version
        }
        tools {
            id
            name
            description
            version
        }
        tags {
            id
            key
            value
        }
        auditData {
            createdByUserId
            createdTime
            modifiedByUserId
            modifiedTime
            createdByOrigin
            updatedByOrigin
            updatedAtProviderTime
        }
    }
}

Example Response (success):

{
    "data": {
        "aiAgentTaskCreate": {
            "id": "c5839cd7-4936-4c83-8d14-bb2aa12b6cda",
            "externalId": null,
            "name": "Summarize Customer Ticket",
            "description": "Summarizes an inbound support ticket",
            "instructions": ["Read the ticket body", "Produce a two-sentence summary"],
            "version": "DRAFT",
            "taskStatus": "ACTIVE",
            "metaData": "{ \"category\": \"support\" }",
            "agentVersions": [
                { "id": "e7fabdf1-b88e-4b3f-b0fd-eacb332073f5", "name": "Alpha", "version": "DRAFT" }
            ],
            "tools": [
                { "id": "ff50061f-2bec-464e-afb3-8e7d9ea983a5", "name": "Customer Data Analyzer", "description": "Analyzes customer data", "version": "DRAFT" }
            ],
            "tags": [
                { "id": "6f9fe561-2381-488a-92ca-0b79f1c52316", "key": "category", "value": "support" }
            ],
            "auditData": {
                "createdByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "createdTime": "2026-09-17T10:00:00Z",
                "modifiedByUserId": "617b34c7-d14f-4a7b-a0fe-9047031618c5",
                "modifiedTime": "2026-09-17T10:00:00Z",
                "createdByOrigin": "REGISTRY",
                "updatedByOrigin": "REGISTRY",
                "updatedAtProviderTime": null
            }
        }
    }
}

aiAgentTaskCreate(
  input: AiAgentTaskCreateInput!
): AiAgentTask

Arguments

aiAgentTaskCreate.input ● AiAgentTaskCreateInput! non-null input agent-control-tower {#input}

Type

AiAgentTask object agent-control-tower