Create calendar event
create_calendar_eventYou need earnings dates, guidance, targets, milestones, investor events, regulatory dates, product events, macro dates, or preparation and outcome context.
When to use it
You need earnings dates, guidance, targets, milestones, investor events, regulatory dates, product events, macro dates, or preparation and outcome context.
List the relevant date window, read the selected event and its history, then create or update with cited Project context. Delete only after explicit user approval.
Calendar event dates, confidence, status, importance, Project and company links, supporting resources, optimistic timestamps, and immutable history.
Avoid using it when
You need a recurring monitoring checklist rather than a scheduled event, or the user has not explicitly approved permanent deletion.
Advanced input contract
Agent hosts use this JSON Schema to validate the exact input shape.
View JSON Schema
{
"type": "object",
"properties": {
"folderId": {
"type": [
"string",
"null"
],
"format": "uuid"
},
"eventType": {
"type": "string",
"enum": [
"earnings",
"guidance",
"target",
"milestone",
"investor_day",
"conference",
"regulatory",
"product",
"capital_allocation",
"macro",
"custom"
]
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"summary": {
"type": [
"string",
"null"
],
"maxLength": 1000
},
"description": {
"type": [
"string",
"null"
],
"maxLength": 8000
},
"status": {
"type": "string",
"enum": [
"scheduled",
"completed",
"postponed",
"cancelled"
]
},
"importance": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"critical"
]
},
"datePrecision": {
"type": "string",
"enum": [
"confirmed",
"estimated",
"tentative"
]
},
"allDay": {
"type": "boolean"
},
"startDate": {
"type": [
"string",
"null"
],
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"endDate": {
"type": [
"string",
"null"
],
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"startsAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"endsAt": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"timeZone": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"location": {
"type": [
"string",
"null"
],
"maxLength": 500
},
"expectedImpact": {
"type": [
"string",
"null"
],
"maxLength": 4000
},
"actualOutcome": {
"type": [
"string",
"null"
],
"maxLength": 4000
},
"outcomeVerdict": {
"type": [
"string",
"null"
],
"enum": [
"as_expected",
"better_than_expected",
"worse_than_expected",
"did_not_occur",
null
],
"description": "Human verdict on how the dated catalyst resolved. Setting it records a resolution in the user's track record; null clears it."
},
"preparationNotes": {
"type": [
"string",
"null"
],
"maxLength": 8000
},
"lastVerifiedAt": {
"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",
"post"
]
},
"id": {
"type": "string",
"format": "uuid"
},
"label": {
"type": [
"string",
"null"
],
"maxLength": 240
}
},
"required": [
"type",
"id"
],
"additionalProperties": false
}
]
},
"maxItems": 24
},
"idempotencyKey": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
},
"required": [
"eventType",
"title",
"allDay"
],
"additionalProperties": false
}