naftiko: 1.0.0-alpha2
info:
  label: PostHog API — surveys
  description: 'PostHog API — surveys. 36 operations. Lead operation: surveys. Self-contained Naftiko capability covering
    one Posthog business surface.'
  tags:
  - Posthog
  - surveys
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POSTHOG_API_KEY: POSTHOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: posthog-surveys
    baseUri: ''
    description: PostHog API — surveys business capability. Self-contained, no shared references.
    resources:
    - name: api-projects-project_id-surveys
      path: /api/projects/{project_id}/surveys/
      operations:
      - name: surveyslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: archived
          in: query
          type: boolean
        - 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: search
          in: query
          type: string
          description: A search term.
      - name: surveyslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: archived
          in: query
          type: boolean
        - 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: search
          in: query
          type: string
          description: A search term.
      - name: surveyscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveyscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-surveys-activity
      path: /api/projects/{project_id}/surveys/activity/
      operations:
      - name: surveysallactivityretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: surveysallactivityretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-projects-project_id-surveys-responses_count
      path: /api/projects/{project_id}/surveys/responses_count/
      operations:
      - name: surveysresponsescountretrieve
        method: GET
        description: Get response counts for all surveys.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: surveysresponsescountretrieve
        method: GET
        description: Get response counts for all surveys.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: api-projects-project_id-surveys-stats
      path: /api/projects/{project_id}/surveys/stats/
      operations:
      - name: surveysglobalstatsretrieve
        method: GET
        description: Get aggregated response statistics across all surveys.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: date_from
          in: query
          type: string
          description: Optional ISO timestamp for start date (e.g. 2024-01-01T00:00:00Z)
        - name: date_to
          in: query
          type: string
          description: Optional ISO timestamp for end date (e.g. 2024-01-31T23:59:59Z)
      - name: surveysglobalstatsretrieve
        method: GET
        description: Get aggregated response statistics across all surveys.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: date_from
          in: query
          type: string
          description: Optional ISO timestamp for start date (e.g. 2024-01-01T00:00:00Z)
        - name: date_to
          in: query
          type: string
          description: Optional ISO timestamp for end date (e.g. 2024-01-31T23:59:59Z)
    - name: api-projects-project_id-surveys-id
      path: /api/projects/{project_id}/surveys/{id}/
      operations:
      - name: surveysretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
      - name: surveysretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
      - name: surveysupdate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveysupdate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveyspartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: surveyspartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: surveysdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
      - name: surveysdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
    - name: api-projects-project_id-surveys-id-activity
      path: /api/projects/{project_id}/surveys/{id}/activity/
      operations:
      - name: surveysactivityretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
      - name: surveysactivityretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
    - name: api-projects-project_id-surveys-id-archived-response-uuids
      path: /api/projects/{project_id}/surveys/{id}/archived-response-uuids/
      operations:
      - name: surveysarchivedresponseuuidsretrieve
        method: GET
        description: Get list of archived response UUIDs for HogQL filtering.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
      - name: surveysarchivedresponseuuidsretrieve
        method: GET
        description: Get list of archived response UUIDs for HogQL filtering.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
    - name: api-projects-project_id-surveys-id-duplicate_to_projects
      path: /api/projects/{project_id}/surveys/{id}/duplicate_to_projects/
      operations:
      - name: surveysduplicatetoprojectscreate
        method: POST
        description: Duplicate a survey to multiple projects in a single transaction.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveysduplicatetoprojectscreate
        method: POST
        description: Duplicate a survey to multiple projects in a single transaction.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-surveys-id-generate_translations
      path: /api/projects/{project_id}/surveys/{id}/generate_translations/
      operations:
      - name: surveysgeneratetranslationscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveysgeneratetranslationscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-surveys-id-responses-response_uuid-archive
      path: /api/projects/{project_id}/surveys/{id}/responses/{response_uuid}/archive/
      operations:
      - name: surveysresponsesarchivecreate
        method: POST
        description: Archive a single survey response.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: response_uuid
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveysresponsesarchivecreate
        method: POST
        description: Archive a single survey response.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: response_uuid
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-surveys-id-responses-response_uuid-unarchive
      path: /api/projects/{project_id}/surveys/{id}/responses/{response_uuid}/unarchive/
      operations:
      - name: surveysresponsesunarchivecreate
        method: POST
        description: Unarchive a single survey response.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: response_uuid
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveysresponsesunarchivecreate
        method: POST
        description: Unarchive a single survey response.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: response_uuid
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-surveys-id-stats
      path: /api/projects/{project_id}/surveys/{id}/stats/
      operations:
      - name: surveysstatsretrieve
        method: GET
        description: Get survey response statistics for a specific survey.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: date_from
          in: query
          type: string
          description: Optional ISO timestamp for start date (e.g. 2024-01-01T00:00:00Z)
        - name: date_to
          in: query
          type: string
          description: Optional ISO timestamp for end date (e.g. 2024-01-31T23:59:59Z)
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
      - name: surveysstatsretrieve
        method: GET
        description: Get survey response statistics for a specific survey.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: date_from
          in: query
          type: string
          description: Optional ISO timestamp for start date (e.g. 2024-01-01T00:00:00Z)
        - name: date_to
          in: query
          type: string
          description: Optional ISO timestamp for end date (e.g. 2024-01-31T23:59:59Z)
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
    - name: api-projects-project_id-surveys-id-summarize_responses
      path: /api/projects/{project_id}/surveys/{id}/summarize_responses/
      operations:
      - name: surveyssummarizeresponsescreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveyssummarizeresponsescreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-surveys-id-summary_headline
      path: /api/projects/{project_id}/surveys/{id}/summary_headline/
      operations:
      - name: surveyssummaryheadlinecreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: surveyssummaryheadlinecreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A UUID string identifying this survey.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.POSTHOG_API_KEY}}'
  exposes:
  - type: rest
    namespace: posthog-surveys-rest
    port: 8080
    description: REST adapter for PostHog API — surveys. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/projects/{project-id}/surveys
      name: api-projects-project-id-surveys
      description: REST surface for api-projects-project_id-surveys.
      operations:
      - method: GET
        name: surveyslist
        description: surveyslist
        call: posthog-surveys.surveyslist
        with:
          archived: rest.archived
          limit: rest.limit
          offset: rest.offset
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveyslist
        description: surveyslist
        call: posthog-surveys.surveyslist
        with:
          archived: rest.archived
          limit: rest.limit
          offset: rest.offset
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveyscreate
        description: surveyscreate
        call: posthog-surveys.surveyscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveyscreate
        description: surveyscreate
        call: posthog-surveys.surveyscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/activity
      name: api-projects-project-id-surveys-activity
      description: REST surface for api-projects-project_id-surveys-activity.
      operations:
      - method: GET
        name: surveysallactivityretrieve
        description: surveysallactivityretrieve
        call: posthog-surveys.surveysallactivityretrieve
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysallactivityretrieve
        description: surveysallactivityretrieve
        call: posthog-surveys.surveysallactivityretrieve
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/responses-count
      name: api-projects-project-id-surveys-responses-count
      description: REST surface for api-projects-project_id-surveys-responses_count.
      operations:
      - method: GET
        name: surveysresponsescountretrieve
        description: Get response counts for all surveys.
        call: posthog-surveys.surveysresponsescountretrieve
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysresponsescountretrieve
        description: Get response counts for all surveys.
        call: posthog-surveys.surveysresponsescountretrieve
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/stats
      name: api-projects-project-id-surveys-stats
      description: REST surface for api-projects-project_id-surveys-stats.
      operations:
      - method: GET
        name: surveysglobalstatsretrieve
        description: Get aggregated response statistics across all surveys.
        call: posthog-surveys.surveysglobalstatsretrieve
        with:
          date_from: rest.date_from
          date_to: rest.date_to
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysglobalstatsretrieve
        description: Get aggregated response statistics across all surveys.
        call: posthog-surveys.surveysglobalstatsretrieve
        with:
          date_from: rest.date_from
          date_to: rest.date_to
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}
      name: api-projects-project-id-surveys-id
      description: REST surface for api-projects-project_id-surveys-id.
      operations:
      - method: GET
        name: surveysretrieve
        description: surveysretrieve
        call: posthog-surveys.surveysretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysretrieve
        description: surveysretrieve
        call: posthog-surveys.surveysretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: surveysupdate
        description: surveysupdate
        call: posthog-surveys.surveysupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: surveysupdate
        description: surveysupdate
        call: posthog-surveys.surveysupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: surveyspartialupdate
        description: surveyspartialupdate
        call: posthog-surveys.surveyspartialupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: surveyspartialupdate
        description: surveyspartialupdate
        call: posthog-surveys.surveyspartialupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: surveysdestroy
        description: surveysdestroy
        call: posthog-surveys.surveysdestroy
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: surveysdestroy
        description: surveysdestroy
        call: posthog-surveys.surveysdestroy
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/activity
      name: api-projects-project-id-surveys-id-activity
      description: REST surface for api-projects-project_id-surveys-id-activity.
      operations:
      - method: GET
        name: surveysactivityretrieve
        description: surveysactivityretrieve
        call: posthog-surveys.surveysactivityretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysactivityretrieve
        description: surveysactivityretrieve
        call: posthog-surveys.surveysactivityretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/archived-response-uuids
      name: api-projects-project-id-surveys-id-archived-response-uuids
      description: REST surface for api-projects-project_id-surveys-id-archived-response-uuids.
      operations:
      - method: GET
        name: surveysarchivedresponseuuidsretrieve
        description: Get list of archived response UUIDs for HogQL filtering.
        call: posthog-surveys.surveysarchivedresponseuuidsretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysarchivedresponseuuidsretrieve
        description: Get list of archived response UUIDs for HogQL filtering.
        call: posthog-surveys.surveysarchivedresponseuuidsretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/duplicate-to-projects
      name: api-projects-project-id-surveys-id-duplicate-to-projects
      description: REST surface for api-projects-project_id-surveys-id-duplicate_to_projects.
      operations:
      - method: POST
        name: surveysduplicatetoprojectscreate
        description: Duplicate a survey to multiple projects in a single transaction.
        call: posthog-surveys.surveysduplicatetoprojectscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveysduplicatetoprojectscreate
        description: Duplicate a survey to multiple projects in a single transaction.
        call: posthog-surveys.surveysduplicatetoprojectscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/generate-translations
      name: api-projects-project-id-surveys-id-generate-translations
      description: REST surface for api-projects-project_id-surveys-id-generate_translations.
      operations:
      - method: POST
        name: surveysgeneratetranslationscreate
        description: surveysgeneratetranslationscreate
        call: posthog-surveys.surveysgeneratetranslationscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveysgeneratetranslationscreate
        description: surveysgeneratetranslationscreate
        call: posthog-surveys.surveysgeneratetranslationscreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/responses/{response-uuid}/archive
      name: api-projects-project-id-surveys-id-responses-response-uuid-archive
      description: REST surface for api-projects-project_id-surveys-id-responses-response_uuid-archive.
      operations:
      - method: POST
        name: surveysresponsesarchivecreate
        description: Archive a single survey response.
        call: posthog-surveys.surveysresponsesarchivecreate
        with:
          id: rest.id
          response_uuid: rest.response_uuid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveysresponsesarchivecreate
        description: Archive a single survey response.
        call: posthog-surveys.surveysresponsesarchivecreate
        with:
          id: rest.id
          response_uuid: rest.response_uuid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/responses/{response-uuid}/unarchive
      name: api-projects-project-id-surveys-id-responses-response-uuid-unarchive
      description: REST surface for api-projects-project_id-surveys-id-responses-response_uuid-unarchive.
      operations:
      - method: POST
        name: surveysresponsesunarchivecreate
        description: Unarchive a single survey response.
        call: posthog-surveys.surveysresponsesunarchivecreate
        with:
          id: rest.id
          response_uuid: rest.response_uuid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveysresponsesunarchivecreate
        description: Unarchive a single survey response.
        call: posthog-surveys.surveysresponsesunarchivecreate
        with:
          id: rest.id
          response_uuid: rest.response_uuid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/stats
      name: api-projects-project-id-surveys-id-stats
      description: REST surface for api-projects-project_id-surveys-id-stats.
      operations:
      - method: GET
        name: surveysstatsretrieve
        description: Get survey response statistics for a specific survey.
        call: posthog-surveys.surveysstatsretrieve
        with:
          date_from: rest.date_from
          date_to: rest.date_to
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: surveysstatsretrieve
        description: Get survey response statistics for a specific survey.
        call: posthog-surveys.surveysstatsretrieve
        with:
          date_from: rest.date_from
          date_to: rest.date_to
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/summarize-responses
      name: api-projects-project-id-surveys-id-summarize-responses
      description: REST surface for api-projects-project_id-surveys-id-summarize_responses.
      operations:
      - method: POST
        name: surveyssummarizeresponsescreate
        description: surveyssummarizeresponsescreate
        call: posthog-surveys.surveyssummarizeresponsescreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveyssummarizeresponsescreate
        description: surveyssummarizeresponsescreate
        call: posthog-surveys.surveyssummarizeresponsescreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/surveys/{id}/summary-headline
      name: api-projects-project-id-surveys-id-summary-headline
      description: REST surface for api-projects-project_id-surveys-id-summary_headline.
      operations:
      - method: POST
        name: surveyssummaryheadlinecreate
        description: surveyssummaryheadlinecreate
        call: posthog-surveys.surveyssummaryheadlinecreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: surveyssummaryheadlinecreate
        description: surveyssummaryheadlinecreate
        call: posthog-surveys.surveyssummaryheadlinecreate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: posthog-surveys-mcp
    port: 9090
    transport: http
    description: MCP adapter for PostHog API — surveys. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: surveyslist
      description: surveyslist
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveyslist
      with:
        archived: tools.archived
        limit: tools.limit
        offset: tools.offset
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyslist-2
      description: surveyslist
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveyslist
      with:
        archived: tools.archived
        limit: tools.limit
        offset: tools.offset
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyscreate
      description: surveyscreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveyscreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyscreate-2
      description: surveyscreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveyscreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysallactivityretrieve
      description: surveysallactivityretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysallactivityretrieve
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysallactivityretrieve-2
      description: surveysallactivityretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysallactivityretrieve
      outputParameters:
      - type: object
        mapping: $.
    - name: get-response-counts-all-surveys
      description: Get response counts for all surveys.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysresponsescountretrieve
      outputParameters:
      - type: object
        mapping: $.
    - name: get-response-counts-all-surveys-2
      description: Get response counts for all surveys.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysresponsescountretrieve
      outputParameters:
      - type: object
        mapping: $.
    - name: get-aggregated-response-statistics-across
      description: Get aggregated response statistics across all surveys.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysglobalstatsretrieve
      with:
        date_from: tools.date_from
        date_to: tools.date_to
      outputParameters:
      - type: object
        mapping: $.
    - name: get-aggregated-response-statistics-across-2
      description: Get aggregated response statistics across all surveys.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysglobalstatsretrieve
      with:
        date_from: tools.date_from
        date_to: tools.date_to
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysretrieve
      description: surveysretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysretrieve-2
      description: surveysretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysupdate
      description: surveysupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysupdate-2
      description: surveysupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyspartialupdate
      description: surveyspartialupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-surveys.surveyspartialupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyspartialupdate-2
      description: surveyspartialupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-surveys.surveyspartialupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysdestroy
      description: surveysdestroy
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-surveys.surveysdestroy
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysdestroy-2
      description: surveysdestroy
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-surveys.surveysdestroy
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysactivityretrieve
      description: surveysactivityretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysactivityretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysactivityretrieve-2
      description: surveysactivityretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysactivityretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-archived-response-uuids
      description: Get list of archived response UUIDs for HogQL filtering.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysarchivedresponseuuidsretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-list-archived-response-uuids-2
      description: Get list of archived response UUIDs for HogQL filtering.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysarchivedresponseuuidsretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: duplicate-survey-multiple-projects-single
      description: Duplicate a survey to multiple projects in a single transaction.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysduplicatetoprojectscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: duplicate-survey-multiple-projects-single-2
      description: Duplicate a survey to multiple projects in a single transaction.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysduplicatetoprojectscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysgeneratetranslationscreate
      description: surveysgeneratetranslationscreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysgeneratetranslationscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveysgeneratetranslationscreate-2
      description: surveysgeneratetranslationscreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysgeneratetranslationscreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: archive-single-survey-response
      description: Archive a single survey response.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysresponsesarchivecreate
      with:
        id: tools.id
        response_uuid: tools.response_uuid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: archive-single-survey-response-2
      description: Archive a single survey response.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysresponsesarchivecreate
      with:
        id: tools.id
        response_uuid: tools.response_uuid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: unarchive-single-survey-response
      description: Unarchive a single survey response.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysresponsesunarchivecreate
      with:
        id: tools.id
        response_uuid: tools.response_uuid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: unarchive-single-survey-response-2
      description: Unarchive a single survey response.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveysresponsesunarchivecreate
      with:
        id: tools.id
        response_uuid: tools.response_uuid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: get-survey-response-statistics-specific
      description: Get survey response statistics for a specific survey.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysstatsretrieve
      with:
        date_from: tools.date_from
        date_to: tools.date_to
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: get-survey-response-statistics-specific-2
      description: Get survey response statistics for a specific survey.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-surveys.surveysstatsretrieve
      with:
        date_from: tools.date_from
        date_to: tools.date_to
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyssummarizeresponsescreate
      description: surveyssummarizeresponsescreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveyssummarizeresponsescreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyssummarizeresponsescreate-2
      description: surveyssummarizeresponsescreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveyssummarizeresponsescreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyssummaryheadlinecreate
      description: surveyssummaryheadlinecreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveyssummaryheadlinecreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: surveyssummaryheadlinecreate-2
      description: surveyssummaryheadlinecreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-surveys.surveyssummaryheadlinecreate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.