Scheduling

Create a scheduling proposal

Creates a new scheduling proposal with time slots. The organizer and all participants must be agents in your organization. Requires Pro plan.

post/v1/scheduling/proposals

Request

  • Base URL: https://api.chronary.ai
  • URL: https://api.chronary.ai/v1/scheduling/proposals
  • Auth: HTTP bearer

Request body

titlestring required
descriptionstring
organizer_agent_idstring required
participant_agent_idsstring[] required
calendar_idstring required
expires_atstring date-time
metadataobject

Example request

{
  "title": "Q2 planning sync",
  "description": "Quarterly planning discussion",
  "organizer_agent_id": "agt_abc123def456",
  "participant_agent_ids": [
    "agt_abc123def456",
    "agt_xyz789"
  ],
  "calendar_id": "cal_abc123def456",
  "slots": [
    {
      "start_time": "2026-05-01T10:00:00.000Z",
      "end_time": "2026-05-01T11:00:00.000Z",
      "weight": 1.5,
      "calendar_id": "cal_abc123def456"
    }
  ],
  "expires_at": "2026-05-01T00:00:00.000Z",
  "metadata": {}
}

Response

Proposal created

idstring required
titlestring required
descriptionstring nullable required
organizer_agent_idstring required
participant_agent_idsstring[] required
calendar_idstring required
status'pending' | 'confirmed' | 'expired' | 'cancelled' required
expires_atstring date-time nullable required
resolved_slotobject nullable required
created_event_idstring nullable required
metadataobject required
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "id": "spr_abc123def456",
  "title": "Q2 planning sync",
  "organizer_agent_id": "agt_abc123def456",
  "participant_agent_ids": [
    "agt_abc123def456"
  ],
  "calendar_id": "cal_abc123def456",
  "status": "pending",
  "metadata": {},
  "created_at": "2026-04-15T10:00:00.000Z",
  "updated_at": "2026-04-15T10:00:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.