Cicle API
Cicle
App
Contact
  1. Getting Started
  • Getting Started
    • Introduction
    • Authentication
    • Managing API Keys
    • Rate Limiting
    • Error Codes
  • Companies
    • Overview
    • Get Companies
      GET
  • Teams
    • Overview
    • Get Current Teams
      GET
  • Boards
    • Overview
    • Get Board with Lists and Cards
      GET
    • Get Board with Lists
      GET
  • Lists
    • Overview
    • Get All Lists by Company and Team
      GET
  • Cards
    • Overview
    • Managing Cards
    • Labels And Members
    • Checklists
    • Comments And Discussions
    • Card Members
      • Toggle Multiple Members
    • Card Labels
      • Toggle Multiple Labels
    • Card Cheers
      • Create Cheer on Card
      • Delete Cheer from Card
    • Card Comments
      • Create Comment
      • Get Card Comments
      • Update Comment on Card
      • Delete Comment from Card
    • Comment Cheers
      • Create Cheer on Comment
      • Delete Cheer from Comment
    • Card Discussions
      • Create Discussion on Comment
      • Update Discussion
      • Delete Discussion
    • Discussion Cheers
      • Create Cheer on Discussion
      • Delete Cheer from Discussion
    • Card Attachments
      • Delete Attachment from Card
      • Update Attachment Name on Card
    • Checklists
      • Checklist Items
        • Checklist Item Attachments
          • Delete Attachment from Checklist Item
          • Update Attachment Name on Checklist Item
        • Get Checklist Items
        • Create Checklist Item
        • Get Checklist Item by ID
        • Update Checklist Item Name
        • Update Checklist Item Date
        • Toggle Checklist Item Complete Status
        • Reorder Checklist Item
        • Toggle Members on Checklist Item
        • Copy Checklist Item
        • Delete Checklist Item
      • Get Checklists
      • Create Checklist
      • Update Checklist Name
      • Reorder Checklist Position
      • Copy Checklist
      • Delete Checklist
    • Card Metadata
      • Get Card Company and Team
    • Create Card
      POST
    • Copy Card
      POST
    • Archive Cards
      PATCH
    • Archive Cards Multi Team
      PATCH
    • Copy Cards Multi Team
      PATCH
    • Move Cards Multi Team
      PATCH
    • Update Cards Multi Team
      PATCH
    • Reorder Card Position
      PATCH
    • Update Card
      PATCH
    • Archive Card
      PATCH
    • Unarchive Card
      PATCH
    • Get Card Details
      GET
    • Get List Card
      GET
  • My Tasks
    • List All My Tasks
    • List All My Tasks In List
  • Schemas
    • Card
      • Card
      • Checklist
      • Discussion
      • Checklist Item
      • Attachment
      • Cheer
      • Comment
      • Label
      • List
      • Company
      • Team
  1. Getting Started

Introduction

The Cicle API (Open API) allows you to connect external applications and services to your Cicle workspace. It enables automation, integrations, and custom workflows that extend how your team manages tasks and projects.

What You Can Do#

With the Cicle API, you can:
Read and create tasks (cards) programmatically
Manage checklists, comments, labels, and members
Interact with boards, lists, and teams
Trigger actions based on events from other systems

Example Use Cases#

Here are some ways teams use the Cicle API:
Email to Task — Automatically create a card whenever a customer sends an email to your support inbox. The card can be pre-filled with the customer's name, subject, and message content.
Google Sheets Sync — When a new row is added to a Google Sheet (e.g., a form response), automatically move a card to the appropriate list, add a comment summarizing the entry, or create a new task based on the data.
AI-Powered Summaries — Periodically fetch all completed tasks for a team, send the data to an AI model like Gemini API to generate a summary of what the team accomplished, and post the summary as a comment on a weekly report card.
CI/CD Notifications — When a deployment succeeds or fails, automatically update a card's checklist, change its labels, or move it to a different list to reflect the current status.
Calendar Integration — Sync card deadlines with an external calendar service, or automatically create cards from calendar events.
Reporting Dashboards — Pull card data to build custom dashboards, track team velocity, or generate progress reports for stakeholders.
These are just a few examples. The API can be integrated with any system that supports HTTP requests — webhook receivers, automation platforms like Zapier or n8n, custom scripts, or internal tools.
Next
Authentication
Built with