How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

PostHog task-runs API

The task-runs API from PostHog — 17 operation(s) for task-runs.

PostHog task-runs 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 Runs. 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 19 operations across 17 paths, and defines 51 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.

19 operations 17 paths 51 schemas 6 GET2 PATCH11 POST

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 task-runs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (PersonalAPIKeyAuth).

Paths & Operations 19

Across 17 paths, the API surfaces 19 operations — 6 GET, 2 PATCH, 11 POST. Each is listed below with its method, path, parameters, and response codes.

task-runs 19
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

Schemas 51

The contract defines 51 schemas that model the data the API accepts and returns. The most detailed are Task (19 properties), TaskRunDetail (18 properties), TaskRunBootstrapCreateRequest (12 properties), TaskRunArtifactPrepareUploadResponse (9 properties). Each schema is shown below with its type and property counts.

S3PresignedPost
object
2 properties 2 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
TaskRunErrorResponse
object
6 properties
TaskRunArtifactPrepareUploadResponse
object
9 properties 7 required
ReasoningEffortEnum
string
low - low medium - medium high - high xhigh - xhigh max - max
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
TaskRunUpdateStatusEnum
string
notstarted - notstarted queued - queued inprogress - inprogress completed - completed failed - failed cancelled - cancelled
TaskRunArtifactPresignResponse
object
2 properties 2 required
TaskRunArtifactsPrepareUploadRequest
object
1 property 1 required
TaskRunArtifactUpload
object
6 properties 3 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
TaskRunArtifactTypeEnum
string
plan - plan context - context reference - reference output - output artifact - artifact treesnapshot - treesnapshot userattachment - userattachment
TaskRunAppendLogRequest
object
1 property 1 required
TaskRunArtifactsUploadRequest
object
1 property 1 required
TaskRunArtifactsFinalizeUploadResponse
object
1 property 1 required
ErrorResponse
object
1 property 1 required
TaskRunCommandRequest
object
JSON-RPC request to send a command to the agent server in the sandbox.
4 properties 2 required
SignalReportTaskRelationshipEnum
string
implementation - Implementation
TaskRunRelayMessageRequest
object
1 property 1 required
TaskRunBootstrapCreateRequestEnvironmentEnum
string
local - local cloud - cloud
TaskRunRelayMessageResponse
object
2 properties 1 required
UserBasic
object
9 properties 4 required
TaskRunBootstrapCreateRequest
object
Request body for creating a task run without starting execution yet.
12 properties
TaskRunArtifactsFinalizeUploadRequest
object
1 property 1 required
PaginatedTaskRunDetailList
object
4 properties 2 required
BlankEnum
TaskRunArtifactsUploadResponse
object
1 property 1 required
TaskRunDetail
object
18 properties 11 required
RoleAtOrganizationEnum
string
engineering - Engineering data - Data product - Product Management founder - Founder leadership - Leadership marketing - Marketing sales - Sales / Success othe…
TaskRunArtifactResponse
object
8 properties 4 required
RuntimeAdapterEnum
string
claude - claude codex - codex
PatchedTaskRunUpdate
object
8 properties
TaskRunDetailEnvironmentEnum
string
local - Local cloud - Cloud
Task
object
19 properties 7 required
PatchedTaskRunSetOutputRequest
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

posthog-task-runs-api-openapi.yml Raw ↑

Other APIs PostHog publishes across the network.

PostHog Capture API
PostHog Query API
PostHog Persons API
PostHog Feature Flags API
PostHog Experiments API
PostHog Insights API
PostHog Cohorts API
PostHog Annotations API
PostHog actions API
PostHog activity_log API
PostHog activity_logs API
PostHog advanced_activity_logs API
Where this information came from

This is an independent, third-party profile of PostHog task-runs 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.