Cicle API
Cicle
App
Contact
  1. Cards
  • Getting Started
    • Introduction
    • Authentication
    • Managing API Keys
    • Rate Limiting
    • Error Codes
  • Companies
    • Overview
    • Get Companies
  • Teams
    • Overview
    • Get Current Teams
  • Boards
    • Overview
    • Get Board with Lists and Cards
    • Get Board with Lists
  • Lists
    • Overview
    • Get All Lists by Company and Team
  • 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. Cards

Managing Cards

This guide covers the concepts behind creating, updating, copying, and archiving cards.

Creating Cards#

To create a card, you need to specify which list it belongs to. A card is always created within a list context.
When using a Company API Key, the company and team are automatically scoped from the key's binding. You only need to provide the listId.

What You Can Set#

When creating a card, you can define:
name (required) — The card title
desc — A description of the task
cover — A cover image URL
isPublic — Whether the card is visible to non-members

Updating Cards#

You can update any editable field on a card, including its name, description, cover, and workload estimate.

Copying Cards#

When you copy a card, you specify a destination list. The original card remains unchanged — a new card is created in the target list with the same properties.

Archiving Cards#

Archiving hides a card from default views without permanently deleting it. Archived cards can be restored at any time. This is useful for completed tasks that you want to keep for reference but remove from the active board.

Reordering Cards#

Cards can be moved to different positions within a list or across lists. This is useful for workflow automation where cards move between stages.

Bulk Operations (Multi-Team)#

For integrations that need to operate on multiple cards at once, bulk endpoints allow you to update, archive, copy, or move several cards in a single request.
When to use bulk operations:
Migrating cards between teams
Batch archiving completed tasks
Updating multiple cards with the same change
Copying a set of cards to another team
Using bulk endpoints is more efficient than making individual requests and helps you stay within rate limits.

Accessing Card Details#

You can fetch a card's full details including its checklists, comments, labels, and members. You can also fetch just the list that contains a specific card, which is useful for understanding a card's position in the workflow.
Previous
Overview
Next
Labels And Members
Built with