Waiting for engine...
Skip to main content

AiAgentToolCreateInput

Input type for creating a new AI Agent Tool in the AI Agent Registry.

input AiAgentToolCreateInput {
  providerAccountId: ID!
  toolType: AiAgentToolType!
  name: String!
  externalId: String
  version: String
  description: String
  toolJson: String
  status: AiAgentToolStatus
  updatedByOrigin: AiAgentOriginType
  aiRegistryEntityType: AiRegistryEntityType
  aiRegistryEntityIds: [ID!]
  aiRegistryEntityStatus: String
  resources: [AiAgentToolResourceInput!]
  tags: [AiAgentTagInput!]
}

Fields​

AiAgentToolCreateInput.providerAccountId ● ID! non-null scalar miscellaneous

Unique identifier of the AI Agent Custom Type Provider account where the tool will be created.

AiAgentToolCreateInput.toolType ● AiAgentToolType! non-null enum agent-control-tower

Specifies the classification type of the AI Agent tool.

AiAgentToolCreateInput.name ● String! non-null scalar miscellaneous

Defines the unique identifier or title of the AI agent tool.

AiAgentToolCreateInput.externalId ● String scalar miscellaneous

External identifier from the provider system (e.g., AWS Bedrock, Salesforce).

AiAgentToolCreateInput.version ● String scalar miscellaneous

Specifies the version of the AI agent tool. Values can be null, DRAFT or a numeric value.

AiAgentToolCreateInput.description ● String scalar miscellaneous

Provides detailed information about the AI agent tool's capabilities and features.

AiAgentToolCreateInput.toolJson ● String scalar miscellaneous

Stores the complete tool configuration represented as a JSON string.

AiAgentToolCreateInput.status ● AiAgentToolStatus enum agent-control-tower

Specifies the current status of the AI Agent tool.

AiAgentToolCreateInput.updatedByOrigin ● AiAgentOriginType enum agent-control-tower

Indicates the origin type when creating the tool, either PROVIDER or REGISTRY.

AiAgentToolCreateInput.aiRegistryEntityType ● AiRegistryEntityType enum agent-control-tower

Specifies the AI registry entity type, either VERSION or TASK.

AiAgentToolCreateInput.aiRegistryEntityIds ● [ID!] list scalar miscellaneous

List of AI registry entity identifiers (GUID of respective entity type to which tool needs to be associated).

AiAgentToolCreateInput.aiRegistryEntityStatus ● String scalar miscellaneous

Specifies the current status of the Entity Association.

AiAgentToolCreateInput.resources ● [AiAgentToolResourceInput!] list input agent-control-tower

Array of tool resources associated with the AI Agent tool.

AiAgentToolCreateInput.tags ● [AiAgentTagInput!] list input agent-control-tower

Optional labeling system that allows classification and organization of AI agent tools.

Member Of​

aiAgentToolCreate mutation

On this Page