PostHog API — tasks

naftiko: 1.0.0-alpha2
info:
  label: PostHog API — tasks
  description: 'PostHog API — tasks. 41 operations. Lead operation: List tasks. Self-contained Naftiko capability covering
    one Posthog business surface.'
  tags:
  - Posthog
  - tasks
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POSTHOG_API_KEY: POSTHOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: posthog-tasks
    baseUri: ''
    description: PostHog API — tasks business capability. Self-contained, no shared references.
    resources:
    - name: api-projects-project_id-tasks
      path: /api/projects/{project_id}/tasks/
      operations:
      - name: taskslist
        method: GET
        description: List tasks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_by
          in: query
          type: integer
          description: Filter by creator user ID
        - name: internal
          in: query
          type: boolean
          description: When true, list internal tasks instead of user-facing ones. Honored only in debug environments; ignored
            in production. Defaults to excluding internal tasks.
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: organization
          in: query
          type: string
          description: Filter by repository organization
        - name: origin_product
          in: query
          type: string
          description: Filter by origin product
        - name: repository
          in: query
          type: string
          description: Filter by repository name (can include org/repo format)
        - name: search
          in: query
          type: string
          description: Case-insensitive substring search over task title and description. A numeric value also matches the
            task number. An empty value disables the filter.
        - name: stage
          in: query
          type: string
          description: Filter by task run stage
        - name: status
          in: query
          type: string
          description: Filter tasks by the status of their most recent run.
      - name: taskslist
        method: GET
        description: List tasks
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: created_by
          in: query
          type: integer
          description: Filter by creator user ID
        - name: internal
          in: query
          type: boolean
          description: When true, list internal tasks instead of user-facing ones. Honored only in debug environments; ignored
            in production. Defaults to excluding internal tasks.
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: organization
          in: query
          type: string
          description: Filter by repository organization
        - name: origin_product
          in: query
          type: string
          description: Filter by origin product
        - name: repository
          in: query
          type: string
          description: Filter by repository name (can include org/repo format)
        - name: search
          in: query
          type: string
          description: Case-insensitive substring search over task title and description. A numeric value also matches the
            task number. An empty value disables the filter.
        - name: stage
          in: query
          type: string
          description: Filter by task run stage
        - name: status
          in: query
          type: string
          description: Filter tasks by the status of their most recent run.
      - name: taskscreate
        method: POST
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: taskscreate
        method: POST
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-tasks-repositories
      path: /api/projects/{project_id}/tasks/repositories/
      operations:
      - name: tasksrepositoriesretrieve
        method: GET
        description: List distinct task repositories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: tasksrepositoriesretrieve
        method: GET
        description: List distinct task repositories
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-projects-project_id-tasks-repository_readiness
      path: /api/projects/{project_id}/tasks/repository_readiness/
      operations:
      - name: tasksrepositoryreadinessretrieve
        method: GET
        description: Get repository readiness
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: refresh
          in: query
          type: boolean
        - name: repository
          in: query
          type: string
          description: Repository in org/repo format
          required: true
        - name: window_days
          in: query
          type: integer
      - name: tasksrepositoryreadinessretrieve
        method: GET
        description: Get repository readiness
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: refresh
          in: query
          type: boolean
        - name: repository
          in: query
          type: string
          description: Repository in org/repo format
          required: true
        - name: window_days
          in: query
          type: integer
    - name: api-projects-project_id-tasks-id
      path: /api/projects/{project_id}/tasks/{id}/
      operations:
      - name: tasksretrieve
        method: GET
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
      - name: tasksretrieve
        method: GET
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
      - name: tasksupdate
        method: PUT
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: tasksupdate
        method: PUT
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: taskspartialupdate
        method: PATCH
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: taskspartialupdate
        method: PATCH
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: tasksdestroy
        method: DELETE
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
      - name: tasksdestroy
        method: DELETE
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
    - name: api-projects-project_id-tasks-id-run
      path: /api/projects/{project_id}/tasks/{id}/run/
      operations:
      - name: tasksruncreate
        method: POST
        description: Run task
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: tasksruncreate
        method: POST
        description: Run task
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-tasks-id-staged_artifacts-finalize_upload
      path: /api/projects/{project_id}/tasks/{id}/staged_artifacts/finalize_upload/
      operations:
      - name: tasksstagedartifactsfinalizeuploadcreate
        method: POST
        description: Finalize staged direct uploads for task attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: tasksstagedartifactsfinalizeuploadcreate
        method: POST
        description: Finalize staged direct uploads for task attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-id-staged_artifacts-prepare_upload
      path: /api/projects/{project_id}/tasks/{id}/staged_artifacts/prepare_upload/
      operations:
      - name: tasksstagedartifactsprepareuploadcreate
        method: POST
        description: Prepare staged direct uploads for task attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: tasksstagedartifactsprepareuploadcreate
        method: POST
        description: Prepare staged direct uploads for task attachments
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs
      path: /api/projects/{project_id}/tasks/{task_id}/runs/
      operations:
      - name: tasksrunslist
        method: GET
        description: List task runs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
        - name: task_id
          in: path
          type: string
          required: true
      - name: tasksrunscreate
        method: POST
        description: Create task run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-tasks-task_id-runs-id
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/
      operations:
      - name: tasksrunsretrieve
        method: GET
        description: API for managing task runs. Each run represents an execution of a task.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
      - name: tasksrunspartialupdate
        method: PATCH
        description: Update task run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-tasks-task_id-runs-id-append_log
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/append_log/
      operations:
      - name: tasksrunsappendlogcreate
        method: POST
        description: Append log entries
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-artifacts
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/
      operations:
      - name: tasksrunsartifactscreate
        method: POST
        description: Upload artifacts for a task run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-artifacts-download
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/download/
      operations:
      - name: tasksrunsartifactsdownloadcreate
        method: POST
        description: Download an artifact through the backend
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-artifacts-finalize_upload
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/finalize_upload/
      operations:
      - name: tasksrunsartifactsfinalizeuploadcreate
        method: POST
        description: Finalize direct uploads for task run artifacts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-artifacts-prepare_upload
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/prepare_upload/
      operations:
      - name: tasksrunsartifactsprepareuploadcreate
        method: POST
        description: Prepare direct uploads for task run artifacts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-artifacts-presign
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/artifacts/presign/
      operations:
      - name: tasksrunsartifactspresigncreate
        method: POST
        description: Generate presigned URL for an artifact
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-command
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/command/
      operations:
      - name: tasksrunscommandcreate
        method: POST
        description: Send command to agent server
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-connection_token
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/connection_token/
      operations:
      - name: tasksrunsconnectiontokenretrieve
        method: GET
        description: Get sandbox connection token
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-logs
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/logs/
      operations:
      - name: tasksrunslogsretrieve
        method: GET
        description: Get task run logs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-relay_message
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/relay_message/
      operations:
      - name: tasksrunsrelaymessagecreate
        method: POST
        description: Relay run message to Slack
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-resume_in_cloud
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/resume_in_cloud/
      operations:
      - name: tasksrunsresumeincloudcreate
        method: POST
        description: Resume task run in cloud
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-session_logs
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/session_logs/
      operations:
      - name: tasksrunssessionlogsretrieve
        method: GET
        description: Get filtered task run session logs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: after
          in: query
          type: string
          description: Only return events after this ISO8601 timestamp
        - name: event_types
          in: query
          type: string
          description: Comma-separated list of event types to include
        - name: exclude_types
          in: query
          type: string
          description: Comma-separated list of event types to exclude
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: limit
          in: query
          type: integer
          description: Maximum number of entries to return (default 1000, max 5000)
        - name: offset
          in: query
          type: integer
          description: Zero-based offset into the filtered log entries
        - name: task_id
          in: path
          type: string
          required: true
    - name: api-projects-project_id-tasks-task_id-runs-id-set_output
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/set_output/
      operations:
      - name: tasksrunssetoutputpartialupdate
        method: PATCH
        description: Set run output
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-tasks-task_id-runs-id-start
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/start/
      operations:
      - name: tasksrunsstartcreate
        method: POST
        description: Start task run
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-projects-project_id-tasks-task_id-runs-id-stream
      path: /api/projects/{project_id}/tasks/{task_id}/runs/{id}/stream/
      operations:
      - name: tasksrunsstreamretrieve
        method: GET
        description: API for managing task runs. Each run represents an execution of a task.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this task run.
          required: true
        - name: task_id
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.POSTHOG_API_KEY}}'
  exposes:
  - type: rest
    namespace: posthog-tasks-rest
    port: 8080
    description: REST adapter for PostHog API — tasks. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/api/projects/{project-id}/tasks
      name: api-projects-project-id-tasks
      description: REST surface for api-projects-project_id-tasks.
      operations:
      - method: GET
        name: taskslist
        description: List tasks
        call: posthog-tasks.taskslist
        with:
          created_by: rest.created_by
          internal: rest.internal
          limit: rest.limit
          offset: rest.offset
          organization: rest.organization
          origin_product: rest.origin_product
          repository: rest.repository
          search: rest.search
          stage: rest.stage
          status: rest.status
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: taskslist
        description: List tasks
        call: posthog-tasks.taskslist
        with:
          created_by: rest.created_by
          internal: rest.internal
          limit: rest.limit
          offset: rest.offset
          organization: rest.organization
          origin_product: rest.origin_product
          repository: rest.repository
          search: rest.search
          stage: rest.stage
          status: rest.status
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: taskscreate
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        call: posthog-tasks.taskscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: taskscreate
        description: API for managing tasks within a project. Tasks represent units of work to be performed by an agent.
        call: posthog-tasks.taskscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/tasks/repositories
      name: api-projects-project-id-tasks-repositories
      description: REST surface for api-projects-project_id-tasks-repositories.
      operations:
      - method: GET
        name: tasksrepositoriesretrieve
        description: List distinct task repositories
        call: posthog-tasks.tasksrepositoriesretrieve
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: tasksrepositoriesretrieve
        description: List distinct task repositories
        call: posthog-tasks.tasksrepositoriesretrieve
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/tasks/repository-readiness
      name: api-projects-project-id-tasks-repository-readiness
      

# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/posthog/refs/heads/main/capabilities/posthog-tasks.yaml