veryfront__update_agent_labelAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Can change resources.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project identifier or slug that scopes the tool call. Minimum length: 1. |
agent_id | string | Yes | Provide the agent id. Minimum length: 1. |
source_target_kind | string | No | Provide the source target kind. Values: "project", "main_branch", "preview_branch". |
target_branch_id | string or null | No | Provide the target branch id. |
label_id | string | Yes | Provide the label id. Format: uuid. |
key | string | Yes | Required label key. Trimmed and lowercased; starts with a letter or number and allows letters, numbers, dot, underscore and dash. Minimum length: 1. Maximum length: 64. |
value | string or null | No | Label value. Trimmed; a supplied blank value is invalid. Omit or use null for a key-only label, including on replacement. |
color | string or null | No | Display color. Omit, use null or supply a blank string to clear it, including on replacement. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__update_agent_label",
"arguments": {
"agent_id": "example",
"label_id": "00000000-0000-4000-8000-000000000000",
"key": "example"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
id | string | Yes | Label UUID. Format: uuid. |
resource_kind | string | Yes | Resource to which the label is assigned. Values: "project", "project_agent". |
project_id | string | Yes | Project UUID containing the labeled resource. Format: uuid. |
source_target_kind | string or null | No | The source target kind returned by the tool. |
source_agent_id | string or null | No | The source agent id returned by the tool. |
namespace | string | Yes | Normalized label namespace. API-created labels use user. |
key | string | Yes | Normalized lowercase label key. |
value | string or null | Yes | Trimmed label value, or null for a key-only label. |
color | string or null | No | Trimmed display color, or null when unset. |
created_at | string | Yes | Creation time as an ISO 8601 timestamp. |
updated_at | string | Yes | Last update time as an ISO 8601 timestamp. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"minLength": 1,
"description": "Project identifier or slug that scopes the tool call."
},
"agent_id": {
"type": "string",
"minLength": 1,
"description": "Provide the agent id."
},
"source_target_kind": {
"type": "string",
"enum": [
"project",
"main_branch",
"preview_branch"
],
"description": "Provide the source target kind."
},
"target_branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Provide the target branch id."
},
{
"type": "null",
"description": "Provide the target branch id."
}
],
"description": "Provide the target branch id."
},
"label_id": {
"type": "string",
"format": "uuid",
"description": "Provide the label id."
},
"key": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Required label key. Trimmed and lowercased; starts with a letter or number and allows letters, numbers, dot, underscore and dash."
},
"value": {
"anyOf": [
{
"type": "string",
"maxLength": 128,
"description": "Provide the value."
},
{
"type": "null",
"description": "Provide the value."
}
],
"description": "Label value. Trimmed; a supplied blank value is invalid. Omit or use null for a key-only label, including on replacement."
},
"color": {
"anyOf": [
{
"type": "string",
"maxLength": 32,
"description": "Provide the color."
},
{
"type": "null",
"description": "Provide the color."
}
],
"description": "Display color. Omit, use null or supply a blank string to clear it, including on replacement."
}
},
"required": [
"agent_id",
"label_id",
"key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the update_agent_label tool."
}
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Label UUID."
},
"resource_kind": {
"type": "string",
"enum": [
"project",
"project_agent"
],
"description": "Resource to which the label is assigned."
},
"project_id": {
"type": "string",
"format": "uuid",
"description": "Project UUID containing the labeled resource."
},
"source_target_kind": {
"type": [
"string",
"null"
],
"description": "The source target kind returned by the tool."
},
"source_agent_id": {
"type": [
"string",
"null"
],
"description": "The source agent id returned by the tool."
},
"namespace": {
"type": "string",
"description": "Normalized label namespace. API-created labels use user."
},
"key": {
"type": "string",
"description": "Normalized lowercase label key."
},
"value": {
"type": [
"string",
"null"
],
"description": "Trimmed label value, or null for a key-only label."
},
"color": {
"type": [
"string",
"null"
],
"description": "Trimmed display color, or null when unset."
},
"created_at": {
"type": "string",
"description": "Creation time as an ISO 8601 timestamp."
},
"updated_at": {
"type": "string",
"description": "Last update time as an ISO 8601 timestamp."
}
},
"required": [
"id",
"resource_kind",
"project_id",
"namespace",
"key",
"value",
"created_at",
"updated_at"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Structured result returned by the update_agent_label tool."
}