How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →

Discovery

Learnings

Guidance

Toolbox

Alignment

API Evangelist LLC

PostHog tasks API

The tasks API from PostHog — 24 operation(s) for tasks.

Documentation Provider Profile APIs.io OpenAPI GitHub

PostHog tasks API is one of 139 APIs that PostHog publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, authentication docs, and an AsyncAPI specification.

This API exposes 30 operations across 24 paths, and defines 73 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://app.posthog.com/api.

30 operations 24 paths 73 schemas 1 DELETE10 GET3 PATCH15 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification

OpenAPI 3.2.0

API Version

1.0.0

Base URL

https://app.posthog.com/api

Authentication

HTTP Bearer

Resource Areas

1

Authentication & Security 1

PostHog tasks API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (PersonalAPIKeyAuth).

Paths & Operations 30

Across 24 paths, the API surfaces 30 operations — 1 DELETE, 10 GET, 3 PATCH, 15 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

tasks 30

GET

/api/projects/{project_id}/tasks/

List tasks

tasks_list 11 params → 200

POST

/api/projects/{project_id}/tasks/

API for managing tasks within a project. Tasks represent units of work to be performed by an agent.

tasks_create 1 param body → 201

GET

/api/projects/{project_id}/tasks/{id}/

API for managing tasks within a project. Tasks represent units of work to be performed by an agent.

tasks_retrieve 2 params → 200

PUT

/api/projects/{project_id}/tasks/{id}/

API for managing tasks within a project. Tasks represent units of work to be performed by an agent.

tasks_update 2 params body → 200

PATCH

/api/projects/{project_id}/tasks/{id}/

API for managing tasks within a project. Tasks represent units of work to be performed by an agent.

tasks_partial_update 2 params body → 200

DELETE

/api/projects/{project_id}/tasks/{id}/

API for managing tasks within a project. Tasks represent units of work to be performed by an agent.

tasks_destroy 2 params → 204

POST

/api/projects/{project_id}/tasks/{id}/run/

Run task

tasks_run_create 2 params body → 200400404

POST

/api/projects/{project_id}/tasks/{id}/staged_artifacts/finalize_upload/

Finalize staged direct uploads for task attachments

tasks_staged_artifacts_finalize_upload_create 2 params body → 200400404

POST

/api/projects/{project_id}/tasks/{id}/staged_artifacts/prepare_upload/

Prepare staged direct uploads for task attachments

tasks_staged_artifacts_prepare_upload_create 2 params body → 200400404

GET

/api/projects/{project_id}/tasks/{task_id}/runs/

List task runs

tasks_runs_list 4 params → 200

POST

/api/projects/{project_id}/tasks/{task_id}/runs/

Create task run

tasks_runs_create 2 params body → 201400

GET

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/

API for managing task runs. Each run represents an execution of a task.

tasks_runs_retrieve 3 params → 200

PATCH

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/

Update task run

tasks_runs_partial_update 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/append_log/

Append log entries

tasks_runs_append_log_create 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/

Upload artifacts for a task run

tasks_runs_artifacts_create 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/download/

Download an artifact through the backend

tasks_runs_artifacts_download_create 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/finalize_upload/

Finalize direct uploads for task run artifacts

tasks_runs_artifacts_finalize_upload_create 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/prepare_upload/

Prepare direct uploads for task run artifacts

tasks_runs_artifacts_prepare_upload_create 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/presign/

Generate presigned URL for an artifact

tasks_runs_artifacts_presign_create 3 params body → 200400404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/command/

Send command to agent server

tasks_runs_command_create 3 params body → 200400404502

GET

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/connection_token/

Get sandbox connection token

tasks_runs_connection_token_retrieve 3 params → 200404

GET

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/logs/

Get task run logs

tasks_runs_logs_retrieve 3 params → 200404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/relay_message/

Relay run message to Slack

tasks_runs_relay_message_create 3 params body → 200404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/resume_in_cloud/

Resume task run in cloud

tasks_runs_resume_in_cloud_create 3 params → 200400

GET

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/session_logs/

Get filtered task run session logs

tasks_runs_session_logs_retrieve 8 params → 200404

PATCH

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/set_output/

Set run output

tasks_runs_set_output_partial_update 3 params body → 200404

POST

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/start/

Start task run

tasks_runs_start_create 3 params body → 200400404

GET

/api/projects/{project_id}/tasks/{task_id}/runs/{id}/stream/

API for managing task runs. Each run represents an execution of a task.

tasks_runs_stream_retrieve 3 params → 200

GET

/api/projects/{project_id}/tasks/repositories/

List distinct task repositories

tasks_repositories_retrieve 1 param → 200

GET

/api/projects/{project_id}/tasks/repository_readiness/

Get repository readiness

tasks_repository_readiness_retrieve 4 params → 200

Schemas 73

The contract defines 73 schemas that model the data the API accepts and returns. The most detailed are PatchedTask (19 properties), Task (19 properties), TaskRunDetail (18 properties), CodexTaskRunCreateSchema (14 properties). Each schema is shown below with its type and property counts.

S3PresignedPost

object

2 properties 2 required

TaskStagedArtifactPrepareUploadResponse

object

9 properties 7 required

PrAuthorshipModeEnum

string

user - user bot - bot

TaskRunDetailStatusEnum

string

notstarted - Not Started queued - Queued inprogress - In Progress completed - Completed failed - Failed cancelled - Cancelled

NullEnum

MethodEnum

string

usermessage - usermessage cancel - cancel close - close permissionresponse - permissionresponse setconfigoption - setconfigoption

TaskRunArtifactPrepareUpload

object

5 properties 3 required

ContentEncodingEnum

string

utf-8 - utf-8 base64 - base64

TaskRunStartRequest

object

2 properties

ConnectionTokenResponse

object

Response containing a JWT token for direct sandbox connection

1 property 1 required

OriginProductEnum

string

errortracking - Error Tracking evalclusters - Eval Clusters usercreated - User Created automation - Automation slack - Slack supportqueue - Support Queue sessi…

TaskRunUpdateEnvironmentEnum

string

local - local

TaskExecutionModeEnum

string

interactive - interactive background - background

TaskRunArtifactsPrepareUploadResponse

object

1 property 1 required

ScanEvidence

object

6 properties 6 required

TaskRunErrorResponse

object

6 properties

TaskRunArtifactPrepareUploadResponse

object

9 properties 7 required

ReasoningEffortEnum

string

low - low medium - medium high - high xhigh - xhigh max - max

PatchedTask

object

19 properties

TaskRunArtifactFinalizeUpload

object

6 properties 4 required

TaskRunBootstrapCreateRequestInitialPermissionModeEnum

string

default - default acceptEdits - acceptEdits plan - plan bypassPermissions - bypassPermissions auto - auto read-only - read-only full-access - full-access

TaskRunArtifactPresignRequest

object

1 property 1 required

ClaudeTaskRunCreateSchemaInitialPermissionModeEnum

string

default - default acceptEdits - acceptEdits plan - plan bypassPermissions - bypassPermissions auto - auto

TaskRunUpdateStatusEnum

string

notstarted - notstarted queued - queued inprogress - inprogress completed - completed failed - failed cancelled - cancelled

TaskRunArtifactPresignResponse

object

2 properties 2 required

TaskRunArtifactsFinalizeUploadRequest

object

1 property 1 required

TaskRunArtifactsPrepareUploadRequest

object

1 property 1 required

TaskRepositoriesResponse

object

1 property 1 required

TaskRunArtifactUpload

object

6 properties 3 required

ClaudeTaskRunCreateSchema

object

Request body for creating a new task run

14 properties 2 required

TaskRunCommandResponse

object

Response from the agent server command endpoint.

4 properties 1 required

TaskRunDetailProviderEnum

string

JsonrpcEnum

string

2.0 - 2.0

RunSourceEnum

string

manual - manual signalreport - signalreport

PaginatedTaskList

object

4 properties 2 required

TaskRunArtifactTypeEnum

string

plan - plan context - context reference - reference output - output artifact - artifact treesnapshot - treesnapshot userattachment - userattachment

TaskStagedArtifactPrepareUpload

object

5 properties 3 required

TaskStagedArtifactsFinalizeUploadRequest

object

1 property 1 required

TaskRunArtifactsUploadRequest

object

1 property 1 required

TaskRunAppendLogRequest

object

1 property 1 required

TaskRunArtifactsFinalizeUploadResponse

object

1 property 1 required

ErrorResponse

object

1 property 1 required

CodexTaskRunCreateSchemaInitialPermissionModeEnum

string

auto - auto read-only - read-only full-access - full-access

TaskRunCommandRequest

object

JSON-RPC request to send a command to the agent server in the sandbox.

4 properties 2 required

TaskStagedArtifactFinalizeUpload

object

6 properties 4 required

SignalReportTaskRelationshipEnum

string

implementation - Implementation

CapabilityStateStateEnum

string

needssetup - needssetup detected - detected waitingfordata - waitingfordata ready - ready notapplicable - notapplicable unknown - unknown

TaskStagedArtifactsPrepareUploadResponse

object

1 property 1 required

TaskRunBootstrapCreateRequestEnvironmentEnum

string

local - local cloud - cloud

TaskRunRelayMessageRequest

object

1 property 1 required

ClaudeRuntimeAdapterEnum

string

claude - claude

TaskRunRelayMessageResponse

object

2 properties 1 required

UserBasic

object

9 properties 4 required

CodexTaskRunCreateSchema

object

Request body for creating a new task run

14 properties 2 required

TaskRunBootstrapCreateRequest

object

Request body for creating a task run without starting execution yet.

12 properties

PaginatedTaskRunDetailList

object

4 properties 2 required

TaskRunResumeRequestSchema

object

9 properties

TaskStagedArtifactsPrepareUploadRequest

object

1 property 1 required

CapabilityState

object

4 properties 3 required

BlankEnum

TaskRunArtifactsUploadResponse

object

1 property 1 required

TaskRunArtifactResponse

object

8 properties 4 required

RoleAtOrganizationEnum

string

engineering - Engineering data - Data product - Product Management founder - Founder leadership - Leadership marketing - Marketing sales - Sales / Success othe…

TaskRunDetail

object

18 properties 11 required

CodexRuntimeAdapterEnum

string

codex - codex

RuntimeAdapterEnum

string

claude - claude codex - codex

PatchedTaskRunUpdate

object

8 properties

TaskRunDetailEnvironmentEnum

string

local - Local cloud - Cloud

TaskRunCreateRequestSchema

Task

object

19 properties 7 required

RepositoryReadinessResponse

object

12 properties 11 required

TaskStagedArtifactsFinalizeUploadResponse

object

1 property 1 required

PatchedTaskRunSetOutputRequest

object

1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

Other APIs PostHog publishes across the network.

PostHog Capture API

AE Profile APIs.io

PostHog Query API

AE Profile APIs.io

PostHog Persons API

AE Profile APIs.io

PostHog Feature Flags API

AE Profile APIs.io

PostHog Experiments API

AE Profile APIs.io

PostHog Insights API

AE Profile APIs.io

PostHog Cohorts API

AE Profile APIs.io

PostHog Annotations API

AE Profile APIs.io

PostHog actions API

AE Profile APIs.io

PostHog activity_log API

AE Profile APIs.io

PostHog activity_logs API

AE Profile APIs.io

PostHog advanced_activity_logs API

AE Profile APIs.io

#Task

← Back to P APIs

Call it yourself

curl for this page

Search the network for this

curl "https://api.apievangelist.com/v1/search?q=posthog-tasks-api&limit=10"

Everything under a tag

curl "https://api.apievangelist.com/v1/tags/posthog-tasks-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Where this information came from

This is an independent, third-party profile of PostHog tasks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.