Create agent label

createAgentLabel(input: CreateProjectAgentLabelInput!): AgentLabel!

Requires project.agents.write.

Arguments

ArgumentTypeRequired
inputCreateProjectAgentLabelInput!Yes

Input fields

input

CreateProjectAgentLabelInput

FieldTypeRequiredDescription
projectReferenceStringNo
agentIdID!Yes
sourceTargetKindStringNoSource target: project, main_branch, or preview_branch. Null and omission select project.
targetBranchIdIDNo
labelProjectAgentLabelFields!Yes

Response

Returns AgentLabel!. Open the type for its fields and nested types.

FieldType
idID!
resourceKindString!
projectIdID!
sourceTargetKindString
sourceAgentIdString
namespaceString!
keyString!
valueString

All fields of AgentLabel.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
mutation CreateAgentLabel($input: CreateProjectAgentLabelInput!) {
  createAgentLabel(input: $input) {
    id
    projectId
    createdAt
    updatedAt
    color
  }
}
json
{
  "input": {
    "projectReference": "00000000-0000-4000-8000-000000000001",
    "agentId": "00000000-0000-4000-8000-000000000001",
    "label": {
      "key": "example"
    }
  }
}