API

GET https://t0ggles.com/api/v1/tasks

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

// Fetch tasks from MARKETING project with high priority
const res = await fetch(
  'https://t0ggles.com/api/v1/tasks?projectKey=MARKETING&priority=high&descriptionType=markdown',
  {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      Authorization: 'Bearer YOUR_API_KEY',
    },
  }
);

const data = await res.json();
console.log(data);
/*
{
  success: true,
  tasks: [
    {
      id: "task123",
      parentId: "",
      projectKey: "MARKETING",
      key: 45,
      title: "Launch Campaign Planning",
      description: "## Campaign Details\n\nPlan and execute...",
      coverImageUrl: "",
      assignedUserEmail: "julia@company.com",
      startDate: "2025-03-15T18:00:00.00Z",
      dueDate: "2025-03-25T18:00:00.00Z",
      status: "In Progress",
      tags: ["Urgent", "Campaign"],
      pinToTop: true,
      priority: "high",
      createdAt: "2025-03-10T10:00:00Z",
      createdBy: "owner@company.com",
      updatedAt: "2025-03-12T15:30:00Z",
      updatedBy: "julia@company.com",
      startedAt: "2025-03-11T09:00:00Z",
      startedBy: "julia@company.com",
      endedAt: "",
      endedBy: "",
      properties: {
        "Campaign Type": "Product Launch",
        "Estimated Budget": 8000,
        "Region": "North America"
      }
    }
  ]
}
*/

// Fetch tasks with multiple filters including custom properties
const res = await fetch(
  'https://t0ggles.com/api/v1/tasks?' +
  'projectKey=SWIPER,MARKETING&' +
  'status=In Progress,Review&' +
  'assignedUserEmail=julia@company.com&' +
  'tag=Urgent&' +
  'dueDate=2025-03-15,2025-03-31&' +
  'prop_Region=North America&' +
  'descriptionType=html',
  {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      Authorization: 'Bearer YOUR_API_KEY',
    },
  }
);

const data = await res.json();
console.log(data.tasks);

POST https://t0ggles.com/api/v1/tasks

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        title: 'Launch Campaign Planning',
        projectKey: 'MARKETING',
        assignedUserEmail: 'julia@company.com',
        priority: 'high',
        pinToTop: true,
        tags: ['Urgent', 'Campaign'],
        startDate: new Date(2025, 3, 15),
        dueDate: new Date(2025, 3, 25),
        descriptionType: 'markdown',
        descriptionContent: `
          ## Launch Campaign Timeline

          Tasks to complete before product launch:

          - Finalize creatives and copy
          - Schedule posts on all platforms
          - Coordinate with influencers

          **Due Date:** March 20

          Contact: [Julia](mailto:julia@company.com)
        `,
        properties: {
          // text type property
          'Campaign Type': 'Product Launch',
          // number type property
          'Estimated Budget': 8000,
          // checkbox type property
          'Assets Ready': false,
          // toggle type property
          'Approval Needed': true,
          // date type property
          'Kickoff Date': new Date(2025, 3, 15),
          // url type property
          'Landing Page URL': 'https://company.com/launch',
          // email type property
          'Marketing Lead': 'julia@company.com',
          // person type property
          'Stakeholder': 'pm@company.com',
          // select type property
          'Region': 'North America',
          // multi-select type property
          'Channels': ['Instagram', 'LinkedIn'],
        },
        subtasks: [
          {
            title: 'Finalize creatives and copy',
            projectKey: 'MARKETING',
            descriptionType: 'markdown',
            descriptionContent: `
              ## Finalize creatives and copy

              - Create social media posts
              - Design email newsletter
              - Prepare video content
            `,
          },
        ],
      },
    ],
  }),
});

// { success: true } or { error: true, message: 'error message' }
console.log(await res.json());

PUT https://t0ggles.com/api/v1/tasks

PATCH https://t0ggles.com/api/v1/tasks

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        id: 'task123',
        title: 'Updated Task Title',
        status: 'Done',
        priority: 'high',
      },
    ],
  }),
});

const data = await res.json();
console.log(data);
/*
{
  success: true,
  tasks: [
    {
      id: "task123",
      projectKey: "MARKETING",
      key: 45,
      title: "Updated Task Title",
      url: "https://t0ggles.com/my-board/MARKETING-45"
    }
  ]
}
*/

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        projectKey: 'MARKETING',
        key: 45,
        assignedUserEmail: 'julia@company.com',
        tags: ['Urgent', 'Campaign'],
        dueDate: '2025-04-15',
      },
    ],
  }),
});

console.log(await res.json());

// Using parent task ID
const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        projectKey: 'MARKETING',
        key: 46,
        parentId: 'parentTask123',
      },
    ],
  }),
});

// Or using parent projectKey + key
const res2 = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        projectKey: 'MARKETING',
        key: 46,
        parentProjectKey: 'MARKETING',
        parentKey: 45,
      },
    ],
  }),
});

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        id: 'subtask123',
        parentId: '', // Empty string unlinks from parent
      },
    ],
  }),
});

const res = await fetch('https://t0ggles.com/api/v1/tasks', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    tasks: [
      {
        projectKey: 'MARKETING',
        key: 45,
        status: 'Done',
      },
      {
        projectKey: 'MARKETING',
        key: 46,
        status: 'In Progress',
        assignedUserEmail: 'alex@company.com',
      },
      {
        id: 'task789',
        priority: 'high',
        pinToTop: true,
      },
    ],
  }),
});

GET https://t0ggles.com/api/v1/dependencies

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

// Get all dependencies for the board
const res = await fetch('https://t0ggles.com/api/v1/dependencies', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
});

const data = await res.json();
console.log(data);
/*
{
  success: true,
  dependencies: [
    {
      id: "dep123",
      predecessorId: "task123",
      predecessorKey: 45,
      predecessorProjectKey: "MARKETING",
      predecessorTitle: "Design mockups",
      predecessorUrl: "https://t0ggles.com/my-board/marketing-45",
      successorId: "task456",
      successorKey: 46,
      successorProjectKey: "MARKETING",
      successorTitle: "Implement design",
      successorUrl: "https://t0ggles.com/my-board/marketing-46",
      lagDays: 0,
      createdAt: "2025-03-10T10:00:00Z"
    }
  ]
}
*/

// Get dependencies for a specific task
const res = await fetch(
  'https://t0ggles.com/api/v1/dependencies?taskProjectKey=MARKETING&taskKey=45',
  {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      Authorization: 'Bearer YOUR_API_KEY',
    },
  }
);

const data = await res.json();
console.log(data.dependencies);

POST https://t0ggles.com/api/v1/dependencies

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

// Create dependency using task IDs
const res = await fetch('https://t0ggles.com/api/v1/dependencies', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    predecessorId: 'task123',
    successorId: 'task456',
    lagDays: 1, // 1 day gap between tasks
  }),
});

const data = await res.json();
console.log(data);
/*
{
  success: true,
  dependency: {
    id: "dep789",
    predecessorId: "task123",
    predecessorKey: 45,
    predecessorProjectKey: "MARKETING",
    predecessorTitle: "Design mockups",
    predecessorUrl: "https://t0ggles.com/my-board/marketing-45",
    successorId: "task456",
    successorKey: 46,
    successorProjectKey: "MARKETING",
    successorTitle: "Implement design",
    successorUrl: "https://t0ggles.com/my-board/marketing-46",
    lagDays: 1,
    createdAt: "2025-03-15T14:30:00Z"
  }
}
*/

// Create dependency using project key + task key
const res = await fetch('https://t0ggles.com/api/v1/dependencies', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    predecessorProjectKey: 'MARKETING',
    predecessorKey: 45,
    successorProjectKey: 'MARKETING',
    successorKey: 46,
  }),
});

console.log(await res.json());

DELETE https://t0ggles.com/api/v1/dependencies

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_API_KEY"
}

// Delete by dependency ID
const res = await fetch('https://t0ggles.com/api/v1/dependencies', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    id: 'dep789',
  }),
});

console.log(await res.json());
// { success: true }

// Delete by task identifiers
const res = await fetch('https://t0ggles.com/api/v1/dependencies', {
  method: 'DELETE',
  headers: {
    'Content-Type': 'application/json',
    Authorization: 'Bearer YOUR_API_KEY',
  },
  body: JSON.stringify({
    predecessorProjectKey: 'MARKETING',
    predecessorKey: 45,
    successorProjectKey: 'MARKETING',
    successorKey: 46,
  }),
});

console.log(await res.json());
// { success: true }