List tasks
Get a list of tasks for the current project, with optional filtering by origin product, stage, organization, repository, created_by, and the workflow (hog_flow_id) that created the task. By default, each row includes description. Pass basic=true for a summary row that omits description and includes description_preview, its first 1000 characters. Use the search parameter to match description text server-side.
Request
- Base URL: https://us.posthog.com
- URL: https://us.posthog.com/api/projects/{project_id}/tasks/
- Auth: one of:
- HTTP bearer
- HTTP bearer
Path parameters
Project ID of the project you're trying to access. To find the ID of the project, make a call to /api/projects/.
Query parameters
Local development only. With ph_debug=true, list all project tasks for debugging. Ignored outside local development.
Filter by archived state. Defaults to excluding archived tasks. Use 'true' to list only archived tasks, 'false' for the default, or 'all' to include both.
- true - true
- false - false
- all - all
With true, return basic list rows for summary surfaces: each row omits the full description and includes description_preview, its first 1000 characters. Defaults to false, which returns full task rows with description. The search parameter still matches description text server-side.
Filter tasks to a channel's feed.
Filter tasks by the CI check rollup on their most recent run's pull request, as last observed from GitHub. 'none' means the PR has no checks.
- passing - passing
- failing - failing
- pending - pending
- none - none
Filter by the client that created the task
- posthog_desktop - PostHog Desktop
- posthog_mobile - PostHog Mobile
- posthog_web - PostHog Web
Filter to tasks carrying a thread comment written by this user ID.
Filter by creator user ID
Exclude tasks with this origin product from the results
- onboarding - Onboarding
- error_tracking - Error Tracking
- eval_clusters - Eval Clusters
- user_created - User Created
- slack - Slack
- support_queue - Support Queue
- session_summaries - Session Summaries
- posthog_ai - PostHog AI
- experiments - Experiments
- signal_report - Signal Report
- autoresearch - Autoresearch
- signals_scout - Signals Scout
- scout_suggestions - Signals Scout Suggestions
- support_reply - Support Reply
- hogdesk - HogDesk
- review_hog - ReviewHog
- image_builder - Image Builder
- loop - Loop
- mcp_analytics - MCP Analytics
- signals_chat - Signals Chat
- task_analysis - Task Analysis
- workflow - Workflow
- space_setup - Space Setup
- business_knowledge - Business Knowledge
- metrics_import - Metrics Import
Filter tasks to the runs spawned by this workflow's 'Create AI task' action.
Filter by the internal flag, which controls whether a task is shown by default, not whether it is accessible. Defaults to excluding internal tasks. Use 'all' to include both internal and user-facing tasks, or 'true' to list only internal tasks. All values are available to any team member; access stays governed by task visibility.
- true - true
- false - false
- all - all
Number of results to return per page.
Filter to tasks whose thread mentions this user ID.
The initial index from which to return the results.
Sort order. '-last_activity_at' is newest activity first, where activity means a thread message or a run starting, streaming, or finishing. Defaults to '-created_at'.
- -created_at - -created_at
- -last_activity_at - -last_activity_at
Filter by repository organization
Filter by origin product
With true, only tasks the requesting user has pinned.
Filter tasks by the state of their most recent run's pull request, as last observed from GitHub (webhooks plus the CI follow-up snapshot).
- open - open
- draft - draft
- merged - merged
- closed - closed
Filter by repository name (can include org/repo format)
Case-insensitive substring search over task title and description. A numeric value also matches the task number. An empty value disables the filter.
Filter by task run stage
Filter tasks by the status of their most recent run.
- not_started - not_started
- queued - queued
- in_progress - in_progress
- completed - completed
- failed - failed
- cancelled - cancelled
Response
List of full task rows by default, or basic rows with description_preview when basic=true.
Changes
No recorded changes to this operation across all 1 revision of this API.