POST datetime

ics_parse

1 credit

Parse an ICS calendar string into structured JSON events

Endpoint

POST /api/v1/tools/datetime/ics_parse

Body Parameters

ics_text string required

Example

input Request

{
    "ics_text": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nBEGIN:VEVENT\r\nSUMMARY:Lunch\r\nDTSTART:20240315T120000\r\nDTEND:20240315T130000\r\nEND:VEVENT\r\nEND:VCALENDAR"
}

output Response

{
    "events": [
        {
            "uid": "",
            "dtend": "2024-03-15T13:00:00",
            "dtstart": "2024-03-15T12:00:00",
            "summary": "Lunch",
            "location": "",
            "attendees": [],
            "organizer": "",
            "description": ""
        }
    ],
    "event_count": 1
}

Response Format

HTTP/1.1 200 OK SUCCESS

{
  "success": true,
  "data": {
    "events": [
        {
            "uid": "",
            "dtend": "2024-03-15T13:00:00",
            "dtstart": "2024-03-15T12:00:00",
            "summary": "Lunch",
            "location": "",
            "attendees": [],
            "organizer": "",
            "description": ""
        }
    ],
    "event_count": 1
},
  "meta": {
    "tool": "ics_parse",
    "credits_consumed": 1
  }
}

HTTP/1.1 422 Unprocessable Entity ERROR

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid."
  }
}

Code Examples

Request Example

lightbulb Developer Tip

Credits are deducted before execution. If the upstream tool fails, credits are automatically refunded to your account.