API Documentation

List all projects the authenticated user can access.

Permission required: projects:read

Create a new project.

Permission required: projects:write

curl -X POST https://www.thickethq.com/api/v1/projects \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "name": "Marketing Website",
    "description": "Q2 website redesign"
  }'

Get a single project by ID if the authenticated user can access it.

Permission required: projects:read

Update general project fields like name, description, color, or status.

Permission required: projects:write

Change a project between invite-only and all-access without introducing project-level roles.

curl -X PUT https://www.thickethq.com/api/v1/projects/PROJECT_ID/access   -H "Authorization: Bearer thk_..."   -H "Content-Type: application/json"   -H "User-Agent: MyApp ([email protected])"   -d '{
    "accessType": "ALL_ACCESS"
  }'

# Response
{
  "project": {
    "id": "PROJECT_ID",
    "slug": "marketing-website-ab123",
    "access_type": "ALL_ACCESS"
  },
  "authorization_basis": "ADMIN"
}

Permission required: projects:write

Trash a project.

Permission required: projects:write

List all tools in a project.

Permission required: tools:read

Create a new tool in a project.

Permission required: tools:write

Get a single tool by ID.

Permission required: tools:read

Update a tool.

Permission required: tools:write

Delete a tool from a project.

Permission required: tools:write

Enable a tool.

Permission required: tools:write

Disable a tool.

Permission required: tools:write

Update a tool's position in the project.

Permission required: tools:write

List Grove tools in a project.

Permission required: kanban:read

List cards in a project's Grove board. Returns both a stable flat list and trustworthy grouped column slices.

Permission required: kanban:read

{
  "cards": [
    {
      "id": "...",
      "title": "Tighten API docs",
      "status": "CONSIDERING",
      "position": 0,
      "created_at": "2026-03-09T22:00:00.000Z"
    }
  ],
  "grouped": {
    "CONSIDERING": [
      {
        "id": "...",
        "title": "Tighten API docs",
        "status": "CONSIDERING",
        "position": 0
      }
    ],
    "IN_PROGRESS": [],
    "DONE": []
  },
  "pagination": {
    "flat": {
      "page": 1,
      "per_page": 25,
      "total_count": 47,
      "total_pages": 2,
      "returned_count": 25,
      "has_next_page": true,
      "has_prev_page": false,
      "next_page": 2,
      "prev_page": null,
      "order": {
        "status": ["CONSIDERING", "IN_PROGRESS", "DONE"],
        "position": "asc",
        "created_at": "asc",
        "id": "asc"
      }
    },
    "grouped": {
      "mode": "per-status",
      "page": 1,
      "per_page": 25,
      "status_filter": null,
      "order": {
        "position": "asc",
        "created_at": "asc",
        "id": "asc"
      },
      "statuses": {
        "CONSIDERING": {
          "page": 1,
          "per_page": 25,
          "total_count": 12,
          "total_pages": 1,
          "returned_count": 12,
          "has_next_page": false,
          "has_prev_page": false,
          "next_page": null,
          "prev_page": null
        },
        "IN_PROGRESS": {
          "page": 1,
          "per_page": 25,
          "total_count": 20,
          "total_pages": 1,
          "returned_count": 20,
          "has_next_page": false,
          "has_prev_page": false,
          "next_page": null,
          "prev_page": null
        },
        "DONE": {
          "page": 1,
          "per_page": 25,
          "total_count": 15,
          "total_pages": 1,
          "returned_count": 15,
          "has_next_page": false,
          "has_prev_page": false,
          "next_page": null,
          "prev_page": null
        }
      }
    }
  }
}

Create a new card in a project's Grove board.

Permission required: kanban:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/grove/cards \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "title": "Implement feature X",
    "status": "IN_PROGRESS"
  }'

Get a single Grove card by ID.

Permission required: kanban:read

Update a Grove card. Send only the fields you want to change.

Permission required: kanban:write

Permanently delete a Grove card.

Permission required: kanban:write

Move a card to a new column and position.

Permission required: kanban:write

List all to-do lists in a project.

Permission required: todos:read

Create a new to-do list in a project.

Permission required: todos:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/todolists \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "name": "Launch Checklist"
  }'

Get a single to-do list by ID.

Permission required: todos:read

Update a to-do list.

Permission required: todos:write

Delete a to-do list and all its todos.

Permission required: todos:write

List all todos in a to-do list.

Permission required: todos:read

Create a new todo in a list.

Permission required: todos:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/todolists/LIST_ID/todos \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "content": "Review pull request"
  }'

Get a single todo by ID.

Permission required: todos:read

Update a todo.

Permission required: todos:write

Permanently delete a todo.

Permission required: todos:write

Mark a todo as complete.

Permission required: todos:write

Mark a todo as incomplete.

Permission required: todos:write

Reorder a todo within its list.

Permission required: todos:write

List messages in a project. Returns paginated results.

Permission required: messages:read

Create a new message.

Permission required: messages:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/messages \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "title": "Weekly Update",
    "content": "Here is what we shipped this week..."
  }'

Get a single message by ID.

Permission required: messages:read

Update a message.

Permission required: messages:write

Trash a message.

Permission required: messages:write

Get the project's Schedule tool. Includes links to the schedule entries collection.

Permission required: schedule:read

List schedule entries in a project. Returns paginated results. Recurring entries are occurrence-aware — when date filters are provided, only entries with occurrences in the window are returned.

Recurring entries: When date filters are provided, recurring entries are included only if they have at least one occurrence in the requested window. Recurring entries include next_occurrence and occurrence_end fields — computed relative to the filter window, or relative to now if no date filter is set.

Permission required: schedule:read

Create a new schedule entry.

Permission required: schedule:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/schedule/entries \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "title": "Sprint Planning",
    "start_time": "2026-03-10T10:00:00Z",
    "end_time": "2026-03-10T11:00:00Z",
    "location": "Conference Room B",
    "recurrence_rule": "FREQ=WEEKLY;BYDAY=TU",
    "participant_ids": ["USER_UUID_1", "USER_UUID_2"]
  }'

Get a single schedule entry by ID. Recurring entries include next_occurrence and occurrence_end fields computed relative to now.

Permission required: schedule:read

Update a schedule entry.

Permission required: schedule:write

Trash a schedule entry (soft-delete — sets status to trashed).

Permission required: schedule:write

List occurrences of a schedule entry within a date range. For recurring entries, expands the RRULE into individual occurrences. For non-recurring entries, returns the entry itself if it falls within the range.

Response: { occurrences: [{ start_time, end_time, schedule_entry }] }

Permission required: schedule:read

curl "https://www.thickethq.com/api/v1/projects/PROJECT_ID/schedule/entries/ENTRY_ID/occurrences?starts_after=2026-04-01&starts_before=2026-04-30" \
  -H "Authorization: Bearer thk_..." \
  -H "User-Agent: MyApp ([email protected])"

Get a specific occurrence of a recurring entry by date. The :date parameter must be in YYYYMMDD format. Returns 404 if no occurrence exists on that date.

Permission required: schedule:read

curl "https://www.thickethq.com/api/v1/projects/PROJECT_ID/schedule/entries/ENTRY_ID/occurrences/20260407" \
  -H "Authorization: Bearer thk_..." \
  -H "User-Agent: MyApp ([email protected])"

List documents in a project. Returns paginated results.

Permission required: docs:read

Create a new document.

Permission required: docs:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/documents \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "title": "Engineering Onboarding Guide",
    "content": "Welcome to the team! Here is everything you need...",
    "status": "published"
  }'

Get a single document by ID. Includes the latest 5 versions.

Permission required: docs:read

Update a document. Creates a new version if title or content changed.

Permission required: docs:write

Trash a document.

Permission required: docs:write

List all comments in a project. Optionally filter by content type.

Permission required: comments:read

Add a comment to a message.

Permission required: comments:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/messages/MSG_ID/comments \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "content": "Great update! Looks like we are on track."
  }'

Add a comment to a todo.

Permission required: comments:write

Add a comment to a document.

Permission required: comments:write

Add a comment to a schedule entry.

Permission required: comments:write

Update a comment.

Permission required: comments:write

Trash a comment.

Permission required: comments:write

List chat rooms for a project.

Permission required: chat:read

List lines in a chat room. Returns paginated results, newest first.

Permission required: chat:read

Post a new line to a chat room.

Permission required: chat:write

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/chats/CHAT_ID/lines \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "content": "Deploy looks good, shipping it!"
  }'

Get a single chat line by ID.

Permission required: chat:read

Trash a chat line.

Permission required: chat:write

List all people in your organization.

Permission required: people:read

Get a single person by ID.

Permission required: people:read

List explicit project members. Alias: /api/v1/projects/:id/people

Permission required: people:read

Add an explicit project member. Alias: /api/v1/projects/:id/people

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/people \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "person_id": "PERSON_ID"
  }'

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/people \
  -H "Authorization: Bearer thk_..." \
  -H "Content-Type: application/json" \
  -H "User-Agent: MyApp ([email protected])" \
  -d '{
    "email": "[email protected]"
  }'

This resolves the email against organization membership first, then adds that person as an explicit project member.

Permission required: projects:write

Add yourself as an explicit project member. Alias: /api/v1/projects/:id/people/me

curl -X POST https://www.thickethq.com/api/v1/projects/PROJECT_ID/people/me \
  -H "Authorization: Bearer thk_..." \
  -H "User-Agent: MyApp ([email protected])"

Permission required: projects:write

Remove an explicit project member. Alias: /api/v1/projects/:id/people/:personId

Permission required: projects:write

Get your own profile. No special permission required — any valid token works.

curl https://www.thickethq.com/api/v1/my/profile \
  -H "Authorization: Bearer thk_..." \
  -H "User-Agent: MyApp ([email protected])"

List active webhooks for an organization.

Requires: admin or owner role (session auth)

Create a new webhook. Returns the signing secret once — store it securely.

Requires: admin or owner role (session auth). Max 10 active webhooks per org.

# Example webhook payload POSTed to your URL
{
  "event": "card.created",
  "created_at": "2026-02-27T18:30:00.000Z",
  "data": {
    "card": {
      "id": "...",
      "title": "Implement feature X",
      "status": "IN_PROGRESS"
    },
    "project_id": "project-uuid",
    "tool_id": "grove-board-uuid"
  }
}

Get webhook details and recent delivery history (last 25 deliveries).

Requires: admin or owner role (session auth)

Update a webhook's URL, scheduleEntries, or active status.

Requires: admin or owner role (session auth)

Permanently delete a webhook and its delivery history.

Requires: admin or owner role (session auth)

List active API tokens for an organization.

Requires: admin or owner role (session auth)

Create a new API token. Returns the token value once — store it securely.

Requires: admin or owner role (session auth). Max 25 active tokens per org.

Revoke a token. Takes effect immediately.

Requires: admin or owner role (session auth)