Update Project watchlist item
update_project_watchlist_itemYou need saved Markets watchlist companies or Project conditions, catalysts, risks, milestones, questions, and progress updates.
When to use it
You need saved Markets watchlist companies or Project conditions, catalysts, risks, milestones, questions, and progress updates.
Use Markets watchlist tools for ticker tracking and Project watchlist tools for structured monitoring items. List current state before mutations; watchlist-only work does not require workspace context.
Markets watchlist metadata and mutations, or Project watchlist items, immutable events, evidence, summaries, and order versions.
Avoid using it when
You intend to change thesis fields, claims, catalysts, risks, or research-agenda rows; those consequential writes must use Research Delta proposals.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": "string",
"format": "uuid"
},
"itemId": {
"type": "string",
"format": "uuid"
},
"expectedUpdatedAt": {
"type": "string",
"format": "date-time"
},
"changeSummary": {
"type": "string",
"minLength": 1,
"maxLength": 1000
},
"kind": {
"type": "string",
"enum": [
"thesis_condition",
"catalyst",
"risk",
"milestone",
"question",
"company",
"custom"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 4000
},
"monitoringInstructions": {
"type": [
"string",
"null"
],
"maxLength": 4000
},
"status": {
"type": "string",
"enum": [
"not_started",
"tracking",
"in_progress",
"blocked",
"triggered",
"completed",
"cancelled"
]
},
"priority": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"critical"
]
},
"progressPercent": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 100
},
"targetDate": {
"type": [
"string",
"null"
],
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"reviewCadence": {
"type": "string",
"enum": [
"manual",
"daily",
"weekly",
"monthly",
"quarterly",
"custom"
]
},
"customCadence": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"nextReviewAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"lastCheckedAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"companyLinkId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"linkedResources": {
"type": "array",
"items": {
"oneOf": [
{
"type": "object",
"properties": {
"type": {
"const": "url"
},
"url": {
"type": "string",
"format": "uri",
"maxLength": 2000
},
"label": {
"type": [
"string",
"null"
],
"maxLength": 240
}
},
"required": [
"type",
"url"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"file",
"document",
"artifact"
]
},
"id": {
"type": "string",
"format": "uuid"
},
"label": {
"type": [
"string",
"null"
],
"maxLength": 240
}
},
"required": [
"type",
"id"
],
"additionalProperties": false
}
]
},
"maxItems": 12
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"folderId",
"itemId",
"expectedUpdatedAt",
"changeSummary"
],
"additionalProperties": false
}