task

Fields

Field	Type	Description
id	uuid	Unique identifier for the task (auto-generated)
orgId	uuid	Reference to the organization this task belongs to
circleId	uuid	Reference to the circle this task is associated with
memberId	uuid	Reference to the assigned member (optional)
title	String	Title of the task
description	String	Detailed description of the task
status	Task_Status_Enum	Current status: Open, InProgress, InReview, Blocked, or Done
dueDate	Timestamp	When the task is due (optional)
createdAt	Timestamp	When the task was created (defaults to current timestamp)
archived	Boolean	Whether the task is archived (defaults to false)
private	Boolean	Whether the task is private (defaults to false)

Task Status

The status field accepts the following enum values:

• Open — Task is open and active
• InProgress — Task is currently being worked on
• InReview — Task is under review
• Blocked — Task is blocked by another task or issue
• Done — Task has been completed

Relationships

Object Relationships

• org — The organization this task belongs to
• circle — The circle this task is associated with
• member — The member assigned to this task (if any)

Array Relationships

• logs — Activity logs tracking changes to this task

Query Examples

List Tasks for an Organization

query GetTasks($orgId: uuid!) {
  task(where: { orgId: { _eq: $orgId } }) {
    id
    title
    description
    status
    dueDate
    circle {
      role {
        name
      }
    }
    member {
      name
    }
    logs {
      createdAt
      display
      changes
    }
  }
}

Get a Specific Task

query GetTask($id: uuid!) {
  task_by_pk(id: $id) {
    id
    title
    description
    status
    dueDate
    circle {
      role {
        name
      }
    }
    member {
      name
    }
  }
}

Mutation Examples

Create a Task

mutation CreateTask {
  insert_task_one(
    object: {
      orgId: "your-org-id"
      circleId: "circle-id"
      title: "Implement new feature"
      description: "Add user authentication to the app"
      status: Open
      dueDate: "2024-01-15T00:00:00Z"
      memberId: "assigned-member-id"
    }
  ) {
    id
    title
    status
  }
}

Update a Task

mutation UpdateTask {
  update_task_by_pk(
    pk_columns: { id: "task-id" }
    _set: { status: InProgress, description: "Updated task description" }
  ) {
    id
    status
    description
  }
}

Permissions

Task access is controlled by several factors:

• Circle membership — Circle participants can access their circle’s tasks
• Privacy settings — Private tasks are only visible to assigned members and circle participants
• Organization role — Organization members can access non-private tasks
• Assignment — Assigned members always have access to their tasks