Apply one validated command with the latest revision. A 409 means re-read before retrying. Public signals never establish payment or purchase intent; commercial milestones require separately supplied attributable evidence. Does not contact businesses or execute delivery.
View input schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "Private workspace id owned by the authenticated account."
},
"revision": {
"type": "integer",
"minimum": 1
},
"command": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"update_profile",
"add_opportunity",
"update_opportunity",
"add_business",
"add_evidence",
"add_validation",
"retire_opportunity",
"add_monitor",
"update_monitor",
"record_signal"
]
},
"opportunityId": {
"type": "string",
"format": "uuid"
},
"profile": {
"type": "object",
"additionalProperties": false,
"properties": {
"skills": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 300
}
},
"industries": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 300
}
},
"geographies": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 300
}
},
"excludedActivities": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string",
"maxLength": 300
}
},
"capacity": {
"type": "string",
"maxLength": 1000
}
}
},
"opportunity": {
"type": "object",
"required": [
"title",
"problem"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200
},
"problem": {
"type": "string",
"maxLength": 3000
},
"industry": {
"type": "string"
},
"geography": {
"type": "string"
},
"proposedSolution": {
"type": "string"
},
"requiredSkills": {
"type": "array",
"items": {
"type": "string"
}
},
"uncertainties": {
"type": "array",
"items": {
"type": "string"
}
},
"counterargument": {
"type": "string"
}
},
"additionalProperties": false
},
"patch": {
"type": "object",
"description": "Editable opportunity content only: title, problem, industry, geography, proposedSolution, requiredSkills, uncertainties, counterargument. IDs and stages cannot be patched.",
"additionalProperties": true
},
"business": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"website": {
"type": "string",
"format": "uri"
},
"location": {
"type": "string"
},
"contactPreference": {
"enum": [
"unknown",
"do_not_contact",
"introductions_allowed"
]
},
"contactPreferenceSource": {
"type": "string",
"format": "uri"
},
"contactPreferenceRecordedAt": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"evidence": {
"type": "object",
"required": [
"claim",
"sourceUrl",
"observedAt",
"kind",
"stance"
],
"properties": {
"businessId": {
"type": "string",
"format": "uuid"
},
"claim": {
"type": "string",
"maxLength": 3000
},
"excerpt": {
"type": "string",
"maxLength": 5000
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": "string",
"format": "date-time"
},
"expiresAt": {
"type": "string",
"format": "date-time"
},
"kind": {
"enum": [
"customer_report",
"website_observation",
"owner_statement",
"experiment_result",
"inference"
]
},
"stance": {
"enum": [
"supports",
"contradicts"
]
}
},
"additionalProperties": false
},
"validation": {
"type": "object",
"required": [
"stage",
"summary",
"occurredAt",
"actor",
"evidenceIds",
"businessId"
],
"properties": {
"stage": {
"enum": [
"confirmed",
"interested",
"pilot_agreed",
"paid",
"delivered",
"measured",
"repeatable"
]
},
"summary": {
"type": "string"
},
"occurredAt": {
"type": "string",
"format": "date-time"
},
"actor": {
"type": "string"
},
"evidenceIds": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"format": "uuid"
}
},
"businessId": {
"type": "string",
"format": "uuid"
},
"amount": {
"type": "number",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"metric": {
"type": "string"
},
"baseline": {
"type": "number"
},
"result": {
"type": "number"
},
"unit": {
"type": "string"
}
},
"additionalProperties": false,
"description": "Sequential, same-business milestones require supporting non-inference evidence. Paid requires positive amount/currency and experiment-result payment reference; measured requires metric/baseline/result/unit. Records are user-supplied, not independently audited."
},
"reason": {
"type": "string",
"maxLength": 2000
},
"monitor": {
"type": "object",
"required": [
"name",
"query",
"cadence"
],
"properties": {
"name": {
"type": "string"
},
"query": {
"type": "string"
},
"cadence": {
"enum": [
"daily",
"weekly"
]
},
"opportunityId": {
"type": "string",
"format": "uuid"
}
},
"additionalProperties": false
},
"monitorId": {
"type": "string",
"format": "uuid"
},
"status": {
"enum": [
"active",
"paused"
]
},
"signal": {
"type": "object",
"required": [
"monitorId",
"sourceUrl",
"summary",
"eventDate",
"kind"
],
"properties": {
"monitorId": {
"type": "string",
"format": "uuid"
},
"opportunityId": {
"type": "string",
"format": "uuid"
},
"sourceUrl": {
"type": "string",
"format": "uri"
},
"summary": {
"type": "string"
},
"eventDate": {
"type": "string",
"format": "date-time"
},
"kind": {
"enum": [
"new_evidence",
"changed",
"resolved"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"id",
"revision",
"command"
],
"additionalProperties": false
}