Tasks
How to plan, track, bill and finish work with tasks, including the board, subtasks, materials, time entries, comments and the task lifecycle.
Files
How to store, share and download organization files in drives and folders, with uploads, versions, comments, share links, ZIP downloads and the Files API.
Tasks
How to plan, track, bill and finish work with tasks, including the board, subtasks, materials, time entries, comments and the task lifecycle.
Files
How to store, share and download organization files in drives and folders, with uploads, versions, comments, share links, ZIP downloads and the Files API.
How to schedule agenda items in shared and personal calendars, plan task work on the Planning board, subscribe through iCalendar feeds and import Google Calendar events.
Agenda is the organization's calendar. It holds agenda items in calendars that people own or share, and a Planning board that schedules task work onto people, teams or customers.
Agenda lives under Workspace, Work in the sidebar, next to Tasks and Planning. The routes are:
| Route | Purpose |
|---|---|
/{orgSlug}/agenda | Calendar with Day, Week, Month and Agenda list views. Week is the default. |
/{orgSlug}/agenda/{agendaItemId} | Agenda item detail. |
/{orgSlug}/agenda/calendars | Calendars you can view or manage. |
/{orgSlug}/agenda/calendars/{calendarId} | Calendar settings. |
/{orgSlug}/agenda/planning | Planning board. |
Every agenda item belongs to one calendar. A calendar has a name, description, color, default time zone and an owner, and its owner can share it with users and teams as Viewer or Editor. Each person chooses which calendars are shown in their own view.
Three calendars are reserved. They cannot be deleted or transferred:
| Calendar | Purpose |
|---|---|
| Organization | The default company calendar. |
| Personal | Each user's own calendar. |
| Planning | One organization-wide calendar that holds scheduled task work. It is always shared with every user. |
Calendars imported from Google Calendar are read-only in CentraKit. Their details, ownership, sharing and deletion are managed at the source.
An agenda item follows standard calendar semantics so it can travel through iCalendar feeds:
When you edit or delete a recurring item, choose This event or Entire series.
The Planning board is a timeline of people, teams or customers (Group rows by). It has Day, Week and Month scales and respects working hours. Open tasks that are not scheduled yet sit in a side panel that you can filter and sort by due date or priority.
Assigning a task on the board creates an agenda item on the Planning calendar and links it to the task. The reserved time shows up on the task as a draft time entry until someone confirms it. The board flags scheduling clashes and people who are missing a task's required skills.
Select New agenda item, or select a time slot in the Day, Week or Month view, and fill in the schedule, invitees, recurrence and notifications. Drag an item to move it, or drag its edge to resize it. Open the item for its full detail page, where you can also assign or create a related task.
Open Calendars and select New calendar. In the calendar settings you can:
Open Planning, choose a date and scale, then drag open tasks from the side panel onto a row. Use Reassign task or Remove from planning on a scheduled block. You can also create a task directly from the board.
Suggestions shows AI-proposed draft bars for unscheduled tasks. Accept a suggestion to schedule it, dismiss it, or drag it to another slot. The Suggestions filter shows or hides the draft bars.
Each calendar's settings page can generate a private iCalendar URL for you. Paste it into another calendar app to subscribe to that calendar. The feed is served from /portal/calendars/{token} and is checked against your current access on every request. Anyone with the URL can read the calendar, so use Rotate private URL to invalidate an old one.
Open the Google Calendar integration from Integrations and select Connect Google Calendar. After you sign in with Google, your primary calendar is enabled and imported right away. Enable other calendars under Enable calendar import. Imported events are read-only and appear under your own calendars.
The import is one way. To show CentraKit items in Google Calendar, subscribe to a private iCalendar URL instead.
Not yet available: two-way sync, CalDAV and outbound invitation emails with RSVP handling.
| Key | Grants |
|---|---|
organization.agenda.view | View the agenda and calendars, set personal calendar preferences and notifications, and manage your own private iCalendar URLs. |
organization.agenda.create | Create agenda items and calendars. |
organization.agenda.update | Edit and move agenda items, change calendar details and sharing, and transfer calendars. |
organization.agenda.delete | Delete agenda items and calendars. |
Calendar sharing applies on top of these keys: a calendar Viewer cannot edit its items. Planning also needs organization.tasks.update to assign or unassign tasks and organization.tasks.create to create a task from the board. Opening the Google Calendar integration page and changing import settings requires organization.integrations.manage.
The automatic Agenda item follow-up workflow notifies assignees when an item starts and again one hour after it ends, if the item still exists. See Workflows.
MCP tools for agenda items:
| Tool | Kind |
|---|---|
listAgendaItems | Read |
getAgendaItem | Read |
createAgendaItem | Write |
updateAgendaItem | Write |
moveAgendaItem | Write |
deleteAgendaItem | Write |
The assistant side panel receives the visible agenda as context. See MCP.
Organization paths are relative to /api/v1/organizations/{organizationId}.
| Resource | Operations |
|---|---|
agenda/items | listAgendaItems (GET), createAgendaItem (POST) |
agenda/items/{agendaItemId} | getAgendaItem (GET), updateAgendaItem (PATCH), deleteAgendaItem (DELETE) |
agenda/items/{agendaItemId}/move | moveAgendaItem (POST) |
Two routes sit outside the organization prefix:
GET /api/v1/public/calendars/{token} (downloadPublicCalendarFeed) serves the iCalendar feed behind /portal/calendars/{token}.GET /api/v1/agenda/google-calendar/oauth/start (startGoogleCalendarOAuth) starts the Google sign-in.The Google Calendar sync runs as the cron job GET /api/v1/internal/google-calendar-sync every 5 minutes. See API and OpenAPI.
Last updated on
Tasks
How to plan, track, bill and finish work with tasks, including the board, subtasks, materials, time entries, comments and the task lifecycle.
Files
How to store, share and download organization files in drives and folders, with uploads, versions, comments, share links, ZIP downloads and the Files API.