API

Deadlines Calendar API: what is due, in one place

One calendar of what is due across your Takelan products, plus your own events and an iCal feed.

Get an API key Talk to us

Problems we solve

Does any of this sound like your week?

Deadlines live in six different places.

One list collects them from the products you use, with your own permissions.

I forget a date until it is too late.

See the next 14 days with the critical items first, and subscribe from your own calendar.

A shared calendar link could leak.

The feed link is a revocable token, and it shows only what you can see when it is fetched.

What it does

The Deadlines Calendar API gathers dates that matter from the Takelan products you use into one list. Each product answers for itself with your own permissions, so you only see what you may see.
Add your own events and share them with your organization if you choose. Mark an item as acknowledged, snoozed or done. Those marks are yours alone.
Ask for the next 14 days with the most critical first, which is what the badge in the navigation shows.
Subscribe from your own calendar app with a private iCal feed. The feed link is a revocable token, and you can turn it off at any time. You can also export the current view once as an .ics file, and switch e-mail reminders on.

Example use cases3 examples

Start the week with what is due

Call the upcoming route and show the next 14 days with critical items first.

Put deadlines in your phone calendar

Create a feed and subscribe to the link from your calendar app. Revoke it when you no longer need it.

Add a team date

Create a custom event and share it with your organization.

Try it

Next 14 days, and a custom event

curl https://app.takelan.com/api/v1/calendar/upcoming \
  -H "X-API-Key: $TAKELAN_API_KEY"

curl -X POST https://app.takelan.com/api/v1/calendar/custom \
  -H "X-API-Key: $TAKELAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"title": "Renew wildcard certificate", "start": "2026-12-01T09:00:00Z"}'

Custom events also take an end time, a severity (info, warning or critical), a repeat rule and reminder offsets.

Endpoints8 endpoints

GET /api/v1/calendar/events Events from every product, merged with your custom events and marks.
GET /api/v1/calendar/upcoming The next 14 days, critical first, with counts.
POST /api/v1/calendar/events/{id}/state Acknowledge, snooze, mark done or clear, for you only.
GET /api/v1/calendar/custom Your custom events.
POST /api/v1/calendar/custom Create a custom event.
POST /api/v1/calendar/feed Create a private iCal feed link.
DELETE /api/v1/calendar/feed Revoke the feed link.
GET /api/v1/calendar/export.ics Export the current view once as an .ics file.

Common questions

What shows up in the calendar?

Dates from the Takelan products you use, such as expiries and due items, plus your own events. Each product answers with your permissions.

Can I see it in my own calendar app?

Yes. Create a private iCal feed and subscribe to its link. You can revoke the link at any time.

Are my snoozes shared?

No. Acknowledge, snooze and done marks are per user.

Can I get e-mail reminders?

Yes. A switch for e-mail reminders is part of the calendar access settings.

All API families | Takelan Utilities & APIs | Pricing