Waiting for engine...
Skip to main content

aiAgentTaskCreate

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

Description: This mutation creates a new AI Agent Task associated with the authenticated user's account.

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.
  • version: String - Optional. The version of the AI agent task (could be null, "DRAFT", or numeric).
  • taskStatus: AiAgentTaskStatus - Optional. Status of the task.
  • taskMetaData: String - Optional. Additional task information in JSON format.
  • agentVersionIds: [ID!] - Optional. List of AI Agent Version IDs to associate with this task.
  • agentToolIds: [ID!] - Optional. List of AI Agent Tool IDs associated with this task.
  • updatedByOrigin: AiAgentOriginType - Optional. AI Agent Origin Type, either PROVIDER or REGISTRY.
  • tags: [AiAgentTagInput!] - Optional. Tags for categorization.

Response:

  • Returns the newly created AiAgentTask object.

Example Request:

mutation CreateAiAgentTask {
aiAgentTaskCreate(input: {
providerAccountId: "ai-registry-account-12345",
name: "Data Processing Task",
description: "Task for processing data inputs for AI agents.",
version: "1.0",
taskStatus: PENDING,
taskMetaData: "{ \"priority\": \"high\", \"category\": \"data-processing\" }",
agentVersionIds: ["version-123", "version-456"],
agentToolIds: ["tool-789", "tool-012"],
updatedByOrigin: REGISTRY,
tags: [
{
key: "category"
value: "data-processing"
}
]
}) {
id
externalId
name
description
version
taskStatus
metaData
agentVersions {
id
name
version
}
tools {
id
name
description
}
tags {
id
key
value
}
auditData {
createdByUserId
createdTime
modifiedByUserId
modifiedTime
createdByOrigin
updatedByOrigin
updatedAtProviderTime
}
}
}

aiAgentTaskCreate(
input: AiAgentTaskCreateInput!
): AiAgentTask

Arguments

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

Type

AiAgentTask object agent-control-tower

On this Page