naftiko: 1.0.0-alpha2 info: label: PostHog API — endpoints description: 'PostHog API — endpoints. 52 operations. Lead operation: endpoints. Self-contained Naftiko capability covering one Posthog business surface.' tags: - Posthog - endpoints created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: POSTHOG_API_KEY: POSTHOG_API_KEY capability: consumes: - type: http namespace: posthog-endpoints baseUri: '' description: PostHog API — endpoints business capability. Self-contained, no shared references. resources: - name: api-environments-environment_id-endpoints path: /api/environments/{environment_id}/endpoints/ operations: - name: environmentsendpointslist method: GET description: List all endpoints for the team. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active 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: environmentsendpointslist method: GET description: List all endpoints for the team. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active 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: environmentsendpointscreate method: POST description: Create a new endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointscreate method: POST description: Create a new endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: api-environments-environment_id-endpoints-last_execution_times path: /api/environments/{environment_id}/endpoints/last_execution_times/ operations: - name: environmentsendpointslastexecutiontimescreate method: POST description: Get the last execution times in the past 6 months for multiple endpoints. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: environmentsendpointslastexecutiontimescreate method: POST description: Get the last execution times in the past 6 months for multiple endpoints. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: api-environments-environment_id-endpoints-name path: /api/environments/{environment_id}/endpoints/{name}/ operations: - name: environmentsendpointsretrieve method: GET description: Retrieve an endpoint, or a specific version via ?version=N. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: environmentsendpointsretrieve method: GET description: Retrieve an endpoint, or a specific version via ?version=N. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: environmentsendpointsupdate method: PUT description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointsupdate method: PUT description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointspartialupdate method: PATCH description: Update an existing endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointspartialupdate method: PATCH description: Update an existing endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointsdestroy method: DELETE description: Delete an endpoint and clean up materialized query. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: environmentsendpointsdestroy method: DELETE description: Delete an endpoint and clean up materialized query. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: api-environments-environment_id-endpoints-name-materialization_preview path: /api/environments/{environment_id}/endpoints/{name}/materialization_preview/ operations: - name: environmentsendpointsmaterializationpreviewcreate method: POST description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointsmaterializationpreviewcreate method: POST description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: api-environments-environment_id-endpoints-name-materialization_status path: /api/environments/{environment_id}/endpoints/{name}/materialization_status/ operations: - name: environmentsendpointsmaterializationstatusretrieve method: GET description: Get materialization status for an endpoint. Supports ?version=N query param. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: environmentsendpointsmaterializationstatusretrieve method: GET description: Get materialization status for an endpoint. Supports ?version=N query param. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: api-environments-environment_id-endpoints-name-openapi.json path: /api/environments/{environment_id}/endpoints/{name}/openapi.json/ operations: - name: environmentsendpointsopenapijsonretrieve method: GET description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: version in: query type: integer description: Specific endpoint version to generate the spec for. Defaults to latest. - name: environmentsendpointsopenapijsonretrieve method: GET description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: version in: query type: integer description: Specific endpoint version to generate the spec for. Defaults to latest. - name: api-environments-environment_id-endpoints-name-run path: /api/environments/{environment_id}/endpoints/{name}/run/ operations: - name: environmentsendpointsrunretrieve method: GET description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: environmentsendpointsrunretrieve method: GET description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: environmentsendpointsruncreate method: POST description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsendpointsruncreate method: POST description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: api-environments-environment_id-endpoints-name-versions path: /api/environments/{environment_id}/endpoints/{name}/versions/ operations: - name: environmentsendpointsversionslist method: GET description: List all versions for an endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active in: query type: boolean - name: limit in: query type: integer description: Number of results to return per page. - name: name in: path type: string required: true - name: offset in: query type: integer description: The initial index from which to return the results. - name: environmentsendpointsversionslist method: GET description: List all versions for an endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active in: query type: boolean - name: limit in: query type: integer description: Number of results to return per page. - name: name in: path type: string required: true - name: offset in: query type: integer description: The initial index from which to return the results. - name: api-projects-project_id-endpoints path: /api/projects/{project_id}/endpoints/ operations: - name: endpointslist method: GET description: List all endpoints for the team. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active 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: endpointslist method: GET description: List all endpoints for the team. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active 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: endpointscreate method: POST description: Create a new endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: endpointscreate method: POST description: Create a new endpoint. 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-endpoints-last_execution_times path: /api/projects/{project_id}/endpoints/last_execution_times/ operations: - name: endpointslastexecutiontimescreate method: POST description: Get the last execution times in the past 6 months for multiple endpoints. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: endpointslastexecutiontimescreate method: POST description: Get the last execution times in the past 6 months for multiple endpoints. 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-endpoints-name path: /api/projects/{project_id}/endpoints/{name}/ operations: - name: endpointsretrieve method: GET description: Retrieve an endpoint, or a specific version via ?version=N. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: endpointsretrieve method: GET description: Retrieve an endpoint, or a specific version via ?version=N. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: endpointsupdate method: PUT description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: endpointsupdate method: PUT description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: endpointspartialupdate method: PATCH description: Update an existing endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: endpointspartialupdate method: PATCH description: Update an existing endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: endpointsdestroy method: DELETE description: Delete an endpoint and clean up materialized query. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: endpointsdestroy method: DELETE description: Delete an endpoint and clean up materialized query. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: api-projects-project_id-endpoints-name-materialization_preview path: /api/projects/{project_id}/endpoints/{name}/materialization_preview/ operations: - name: endpointsmaterializationpreviewcreate method: POST description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: endpointsmaterializationpreviewcreate method: POST description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: api-projects-project_id-endpoints-name-materialization_status path: /api/projects/{project_id}/endpoints/{name}/materialization_status/ operations: - name: endpointsmaterializationstatusretrieve method: GET description: Get materialization status for an endpoint. Supports ?version=N query param. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: endpointsmaterializationstatusretrieve method: GET description: Get materialization status for an endpoint. Supports ?version=N query param. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: api-projects-project_id-endpoints-name-openapi.json path: /api/projects/{project_id}/endpoints/{name}/openapi.json/ operations: - name: endpointsopenapijsonretrieve method: GET description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: version in: query type: integer description: Specific endpoint version to generate the spec for. Defaults to latest. - name: endpointsopenapijsonretrieve method: GET description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: version in: query type: integer description: Specific endpoint version to generate the spec for. Defaults to latest. - name: api-projects-project_id-endpoints-name-run path: /api/projects/{project_id}/endpoints/{name}/run/ operations: - name: endpointsrunretrieve method: GET description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: endpointsrunretrieve method: GET description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: endpointsruncreate method: POST description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: endpointsruncreate method: POST description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: name in: path type: string required: true - name: body in: body type: object description: Request body (JSON). required: false - name: api-projects-project_id-endpoints-name-versions path: /api/projects/{project_id}/endpoints/{name}/versions/ operations: - name: endpointsversionslist method: GET description: List all versions for an endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active in: query type: boolean - name: limit in: query type: integer description: Number of results to return per page. - name: name in: path type: string required: true - name: offset in: query type: integer description: The initial index from which to return the results. - name: endpointsversionslist method: GET description: List all versions for an endpoint. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: created_by in: query type: integer - name: is_active in: query type: boolean - name: limit in: query type: integer description: Number of results to return per page. - name: name in: path type: string required: true - name: offset in: query type: integer description: The initial index from which to return the results. authentication: type: bearer token: '{{env.POSTHOG_API_KEY}}' exposes: - type: rest namespace: posthog-endpoints-rest port: 8080 description: REST adapter for PostHog API — endpoints. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/api/environments/{environment-id}/endpoints name: api-environments-environment-id-endpoints description: REST surface for api-environments-environment_id-endpoints. operations: - method: GET name: environmentsendpointslist description: List all endpoints for the team. call: posthog-endpoints.environmentsendpointslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit offset: rest.offset outputParameters: - type: object mapping: $. - method: GET name: environmentsendpointslist description: List all endpoints for the team. call: posthog-endpoints.environmentsendpointslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit offset: rest.offset outputParameters: - type: object mapping: $. - method: POST name: environmentsendpointscreate description: Create a new endpoint. call: posthog-endpoints.environmentsendpointscreate with: body: rest.body outputParameters: - type: object mapping: $. - method: POST name: environmentsendpointscreate description: Create a new endpoint. call: posthog-endpoints.environmentsendpointscreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/last-execution-times name: api-environments-environment-id-endpoints-last-execution-times description: REST surface for api-environments-environment_id-endpoints-last_execution_times. operations: - method: POST name: environmentsendpointslastexecutiontimescreate description: Get the last execution times in the past 6 months for multiple endpoints. call: posthog-endpoints.environmentsendpointslastexecutiontimescreate with: body: rest.body outputParameters: - type: object mapping: $. - method: POST name: environmentsendpointslastexecutiontimescreate description: Get the last execution times in the past 6 months for multiple endpoints. call: posthog-endpoints.environmentsendpointslastexecutiontimescreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/{name} name: api-environments-environment-id-endpoints-name description: REST surface for api-environments-environment_id-endpoints-name. operations: - method: GET name: environmentsendpointsretrieve description: Retrieve an endpoint, or a specific version via ?version=N. call: posthog-endpoints.environmentsendpointsretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: GET name: environmentsendpointsretrieve description: Retrieve an endpoint, or a specific version via ?version=N. call: posthog-endpoints.environmentsendpointsretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: PUT name: environmentsendpointsupdate description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. call: posthog-endpoints.environmentsendpointsupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: environmentsendpointsupdate description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. call: posthog-endpoints.environmentsendpointsupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: environmentsendpointspartialupdate description: Update an existing endpoint. call: posthog-endpoints.environmentsendpointspartialupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: environmentsendpointspartialupdate description: Update an existing endpoint. call: posthog-endpoints.environmentsendpointspartialupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: environmentsendpointsdestroy description: Delete an endpoint and clean up materialized query. call: posthog-endpoints.environmentsendpointsdestroy with: name: rest.name outputParameters: - type: object mapping: $. - method: DELETE name: environmentsendpointsdestroy description: Delete an endpoint and clean up materialized query. call: posthog-endpoints.environmentsendpointsdestroy with: name: rest.name outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/{name}/materialization-preview name: api-environments-environment-id-endpoints-name-materialization-preview description: REST surface for api-environments-environment_id-endpoints-name-materialization_preview. operations: - method: POST name: environmentsendpointsmaterializationpreviewcreate description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. call: posthog-endpoints.environmentsendpointsmaterializationpreviewcreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: POST name: environmentsendpointsmaterializationpreviewcreate description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. call: posthog-endpoints.environmentsendpointsmaterializationpreviewcreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/{name}/materialization-status name: api-environments-environment-id-endpoints-name-materialization-status description: REST surface for api-environments-environment_id-endpoints-name-materialization_status. operations: - method: GET name: environmentsendpointsmaterializationstatusretrieve description: Get materialization status for an endpoint. Supports ?version=N query param. call: posthog-endpoints.environmentsendpointsmaterializationstatusretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: GET name: environmentsendpointsmaterializationstatusretrieve description: Get materialization status for an endpoint. Supports ?version=N query param. call: posthog-endpoints.environmentsendpointsmaterializationstatusretrieve with: name: rest.name outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/{name}/openapi-json name: api-environments-environment-id-endpoints-name-openapi-json description: REST surface for api-environments-environment_id-endpoints-name-openapi.json. operations: - method: GET name: environmentsendpointsopenapijsonretrieve description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. call: posthog-endpoints.environmentsendpointsopenapijsonretrieve with: name: rest.name version: rest.version outputParameters: - type: object mapping: $. - method: GET name: environmentsendpointsopenapijsonretrieve description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. call: posthog-endpoints.environmentsendpointsopenapijsonretrieve with: name: rest.name version: rest.version outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/{name}/run name: api-environments-environment-id-endpoints-name-run description: REST surface for api-environments-environment_id-endpoints-name-run. operations: - method: GET name: environmentsendpointsrunretrieve description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.environmentsendpointsrunretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: GET name: environmentsendpointsrunretrieve description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.environmentsendpointsrunretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: POST name: environmentsendpointsruncreate description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.environmentsendpointsruncreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: POST name: environmentsendpointsruncreate description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.environmentsendpointsruncreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/endpoints/{name}/versions name: api-environments-environment-id-endpoints-name-versions description: REST surface for api-environments-environment_id-endpoints-name-versions. operations: - method: GET name: environmentsendpointsversionslist description: List all versions for an endpoint. call: posthog-endpoints.environmentsendpointsversionslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit name: rest.name offset: rest.offset outputParameters: - type: object mapping: $. - method: GET name: environmentsendpointsversionslist description: List all versions for an endpoint. call: posthog-endpoints.environmentsendpointsversionslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit name: rest.name offset: rest.offset outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints name: api-projects-project-id-endpoints description: REST surface for api-projects-project_id-endpoints. operations: - method: GET name: endpointslist description: List all endpoints for the team. call: posthog-endpoints.endpointslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit offset: rest.offset outputParameters: - type: object mapping: $. - method: GET name: endpointslist description: List all endpoints for the team. call: posthog-endpoints.endpointslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit offset: rest.offset outputParameters: - type: object mapping: $. - method: POST name: endpointscreate description: Create a new endpoint. call: posthog-endpoints.endpointscreate with: body: rest.body outputParameters: - type: object mapping: $. - method: POST name: endpointscreate description: Create a new endpoint. call: posthog-endpoints.endpointscreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/last-execution-times name: api-projects-project-id-endpoints-last-execution-times description: REST surface for api-projects-project_id-endpoints-last_execution_times. operations: - method: POST name: endpointslastexecutiontimescreate description: Get the last execution times in the past 6 months for multiple endpoints. call: posthog-endpoints.endpointslastexecutiontimescreate with: body: rest.body outputParameters: - type: object mapping: $. - method: POST name: endpointslastexecutiontimescreate description: Get the last execution times in the past 6 months for multiple endpoints. call: posthog-endpoints.endpointslastexecutiontimescreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/{name} name: api-projects-project-id-endpoints-name description: REST surface for api-projects-project_id-endpoints-name. operations: - method: GET name: endpointsretrieve description: Retrieve an endpoint, or a specific version via ?version=N. call: posthog-endpoints.endpointsretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: GET name: endpointsretrieve description: Retrieve an endpoint, or a specific version via ?version=N. call: posthog-endpoints.endpointsretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: PUT name: endpointsupdate description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. call: posthog-endpoints.endpointsupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: PUT name: endpointsupdate description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. call: posthog-endpoints.endpointsupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: endpointspartialupdate description: Update an existing endpoint. call: posthog-endpoints.endpointspartialupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: endpointspartialupdate description: Update an existing endpoint. call: posthog-endpoints.endpointspartialupdate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: endpointsdestroy description: Delete an endpoint and clean up materialized query. call: posthog-endpoints.endpointsdestroy with: name: rest.name outputParameters: - type: object mapping: $. - method: DELETE name: endpointsdestroy description: Delete an endpoint and clean up materialized query. call: posthog-endpoints.endpointsdestroy with: name: rest.name outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/{name}/materialization-preview name: api-projects-project-id-endpoints-name-materialization-preview description: REST surface for api-projects-project_id-endpoints-name-materialization_preview. operations: - method: POST name: endpointsmaterializationpreviewcreate description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. call: posthog-endpoints.endpointsmaterializationpreviewcreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: POST name: endpointsmaterializationpreviewcreate description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. call: posthog-endpoints.endpointsmaterializationpreviewcreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/{name}/materialization-status name: api-projects-project-id-endpoints-name-materialization-status description: REST surface for api-projects-project_id-endpoints-name-materialization_status. operations: - method: GET name: endpointsmaterializationstatusretrieve description: Get materialization status for an endpoint. Supports ?version=N query param. call: posthog-endpoints.endpointsmaterializationstatusretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: GET name: endpointsmaterializationstatusretrieve description: Get materialization status for an endpoint. Supports ?version=N query param. call: posthog-endpoints.endpointsmaterializationstatusretrieve with: name: rest.name outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/{name}/openapi-json name: api-projects-project-id-endpoints-name-openapi-json description: REST surface for api-projects-project_id-endpoints-name-openapi.json. operations: - method: GET name: endpointsopenapijsonretrieve description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. call: posthog-endpoints.endpointsopenapijsonretrieve with: name: rest.name version: rest.version outputParameters: - type: object mapping: $. - method: GET name: endpointsopenapijsonretrieve description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. call: posthog-endpoints.endpointsopenapijsonretrieve with: name: rest.name version: rest.version outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/{name}/run name: api-projects-project-id-endpoints-name-run description: REST surface for api-projects-project_id-endpoints-name-run. operations: - method: GET name: endpointsrunretrieve description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.endpointsrunretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: GET name: endpointsrunretrieve description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.endpointsrunretrieve with: name: rest.name outputParameters: - type: object mapping: $. - method: POST name: endpointsruncreate description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.endpointsruncreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - method: POST name: endpointsruncreate description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. call: posthog-endpoints.endpointsruncreate with: name: rest.name body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/endpoints/{name}/versions name: api-projects-project-id-endpoints-name-versions description: REST surface for api-projects-project_id-endpoints-name-versions. operations: - method: GET name: endpointsversionslist description: List all versions for an endpoint. call: posthog-endpoints.endpointsversionslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit name: rest.name offset: rest.offset outputParameters: - type: object mapping: $. - method: GET name: endpointsversionslist description: List all versions for an endpoint. call: posthog-endpoints.endpointsversionslist with: created_by: rest.created_by is_active: rest.is_active limit: rest.limit name: rest.name offset: rest.offset outputParameters: - type: object mapping: $. - type: mcp namespace: posthog-endpoints-mcp port: 9090 transport: http description: MCP adapter for PostHog API — endpoints. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: list-all-endpoints-team description: List all endpoints for the team. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit offset: tools.offset outputParameters: - type: object mapping: $. - name: list-all-endpoints-team-2 description: List all endpoints for the team. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit offset: tools.offset outputParameters: - type: object mapping: $. - name: create-new-endpoint description: Create a new endpoint. hints: readOnly: false destructive: false idempotent: false call: posthog-endpoints.environmentsendpointscreate with: body: tools.body outputParameters: - type: object mapping: $. - name: create-new-endpoint-2 description: Create a new endpoint. hints: readOnly: false destructive: false idempotent: false call: posthog-endpoints.environmentsendpointscreate with: body: tools.body outputParameters: - type: object mapping: $. - name: get-last-execution-times-past description: Get the last execution times in the past 6 months for multiple endpoints. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.environmentsendpointslastexecutiontimescreate with: body: tools.body outputParameters: - type: object mapping: $. - name: get-last-execution-times-past-2 description: Get the last execution times in the past 6 months for multiple endpoints. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.environmentsendpointslastexecutiontimescreate with: body: tools.body outputParameters: - type: object mapping: $. - name: retrieve-endpoint-specific-version-version-n description: Retrieve an endpoint, or a specific version via ?version=N. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: retrieve-endpoint-specific-version-version-n-2 description: Retrieve an endpoint, or a specific version via ?version=N. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: update-existing-endpoint-parameters-are description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: update-existing-endpoint-parameters-are-2 description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: update-existing-endpoint description: Update an existing endpoint. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.environmentsendpointspartialupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: update-existing-endpoint-2 description: Update an existing endpoint. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.environmentsendpointspartialupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: delete-endpoint-and-clean-up description: Delete an endpoint and clean up materialized query. hints: readOnly: false destructive: true idempotent: true call: posthog-endpoints.environmentsendpointsdestroy with: name: tools.name outputParameters: - type: object mapping: $. - name: delete-endpoint-and-clean-up-2 description: Delete an endpoint and clean up materialized query. hints: readOnly: false destructive: true idempotent: true call: posthog-endpoints.environmentsendpointsdestroy with: name: tools.name outputParameters: - type: object mapping: $. - name: preview-materialization-transform-endpoint-shows description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.environmentsendpointsmaterializationpreviewcreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: preview-materialization-transform-endpoint-shows-2 description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.environmentsendpointsmaterializationpreviewcreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: get-materialization-status-endpoint-supports description: Get materialization status for an endpoint. Supports ?version=N query param. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsmaterializationstatusretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: get-materialization-status-endpoint-supports-2 description: Get materialization status for an endpoint. Supports ?version=N query param. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsmaterializationstatusretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: get-openapi-3-0-specification-this description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsopenapijsonretrieve with: name: tools.name version: tools.version outputParameters: - type: object mapping: $. - name: get-openapi-3-0-specification-this-2 description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsopenapijsonretrieve with: name: tools.name version: tools.version outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsrunretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-2 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsrunretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-3 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.environmentsendpointsruncreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-4 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.environmentsendpointsruncreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: list-all-versions-endpoint description: List all versions for an endpoint. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsversionslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit name: tools.name offset: tools.offset outputParameters: - type: object mapping: $. - name: list-all-versions-endpoint-2 description: List all versions for an endpoint. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.environmentsendpointsversionslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit name: tools.name offset: tools.offset outputParameters: - type: object mapping: $. - name: list-all-endpoints-team-3 description: List all endpoints for the team. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit offset: tools.offset outputParameters: - type: object mapping: $. - name: list-all-endpoints-team-4 description: List all endpoints for the team. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit offset: tools.offset outputParameters: - type: object mapping: $. - name: create-new-endpoint-3 description: Create a new endpoint. hints: readOnly: false destructive: false idempotent: false call: posthog-endpoints.endpointscreate with: body: tools.body outputParameters: - type: object mapping: $. - name: create-new-endpoint-4 description: Create a new endpoint. hints: readOnly: false destructive: false idempotent: false call: posthog-endpoints.endpointscreate with: body: tools.body outputParameters: - type: object mapping: $. - name: get-last-execution-times-past-3 description: Get the last execution times in the past 6 months for multiple endpoints. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.endpointslastexecutiontimescreate with: body: tools.body outputParameters: - type: object mapping: $. - name: get-last-execution-times-past-4 description: Get the last execution times in the past 6 months for multiple endpoints. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.endpointslastexecutiontimescreate with: body: tools.body outputParameters: - type: object mapping: $. - name: retrieve-endpoint-specific-version-version-n-3 description: Retrieve an endpoint, or a specific version via ?version=N. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: retrieve-endpoint-specific-version-version-n-4 description: Retrieve an endpoint, or a specific version via ?version=N. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: update-existing-endpoint-parameters-are-3 description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.endpointsupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: update-existing-endpoint-parameters-are-4 description: Update an existing endpoint. Parameters are optional. Pass version in body or ?version=N query param to target a specific version. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.endpointsupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: update-existing-endpoint-3 description: Update an existing endpoint. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.endpointspartialupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: update-existing-endpoint-4 description: Update an existing endpoint. hints: readOnly: false destructive: false idempotent: true call: posthog-endpoints.endpointspartialupdate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: delete-endpoint-and-clean-up-3 description: Delete an endpoint and clean up materialized query. hints: readOnly: false destructive: true idempotent: true call: posthog-endpoints.endpointsdestroy with: name: tools.name outputParameters: - type: object mapping: $. - name: delete-endpoint-and-clean-up-4 description: Delete an endpoint and clean up materialized query. hints: readOnly: false destructive: true idempotent: true call: posthog-endpoints.endpointsdestroy with: name: tools.name outputParameters: - type: object mapping: $. - name: preview-materialization-transform-endpoint-shows-3 description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.endpointsmaterializationpreviewcreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: preview-materialization-transform-endpoint-shows-4 description: Preview the materialization transform for an endpoint. Shows what the query will look like after materialization, including range pair detection and bucket functions. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.endpointsmaterializationpreviewcreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: get-materialization-status-endpoint-supports-3 description: Get materialization status for an endpoint. Supports ?version=N query param. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsmaterializationstatusretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: get-materialization-status-endpoint-supports-4 description: Get materialization status for an endpoint. Supports ?version=N query param. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsmaterializationstatusretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: get-openapi-3-0-specification-this-3 description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsopenapijsonretrieve with: name: tools.name version: tools.version outputParameters: - type: object mapping: $. - name: get-openapi-3-0-specification-this-4 description: Get OpenAPI 3.0 specification for this endpoint. Use this to generate typed SDK clients. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsopenapijsonretrieve with: name: tools.name version: tools.version outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-5 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsrunretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-6 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsrunretrieve with: name: tools.name outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-7 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.endpointsruncreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: execute-endpoint-optional-materialization-supports-8 description: Execute endpoint with optional materialization. Supports version parameter, runs latest version if not set. hints: readOnly: true destructive: false idempotent: false call: posthog-endpoints.endpointsruncreate with: name: tools.name body: tools.body outputParameters: - type: object mapping: $. - name: list-all-versions-endpoint-3 description: List all versions for an endpoint. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsversionslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit name: tools.name offset: tools.offset outputParameters: - type: object mapping: $. - name: list-all-versions-endpoint-4 description: List all versions for an endpoint. hints: readOnly: true destructive: false idempotent: true call: posthog-endpoints.endpointsversionslist with: created_by: tools.created_by is_active: tools.is_active limit: tools.limit name: tools.name offset: tools.offset outputParameters: - type: object mapping: $.