naftiko: 1.0.0-alpha2 info: label: PostHog API — file_system description: 'PostHog API — file_system. 28 operations. Lead operation: file_system. Self-contained Naftiko capability covering one Posthog business surface.' tags: - Posthog - file_system created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: POSTHOG_API_KEY: POSTHOG_API_KEY capability: consumes: - type: http namespace: posthog-file-system baseUri: '' description: PostHog API — file_system business capability. Self-contained, no shared references. resources: - name: api-environments-environment_id-file_system path: /api/environments/{environment_id}/file_system/ operations: - name: environmentsfilesystemlist method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: integer description: Number of results to return per page. - name: offset in: query type: integer description: The initial index from which to return the results. - name: search in: query type: string description: A search term. - name: environmentsfilesystemcreate 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-environments-environment_id-file_system-count_by_path path: /api/environments/{environment_id}/file_system/count_by_path/ operations: - name: environmentsfilesystemcountbypathcreate method: POST description: Get count of all files in a folder. 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-file_system-log_view path: /api/environments/{environment_id}/file_system/log_view/ operations: - name: environmentsfilesystemlogviewretrieve method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: environmentsfilesystemlogviewcreate 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-environments-environment_id-file_system-undo_delete path: /api/environments/{environment_id}/file_system/undo_delete/ operations: - name: environmentsfilesystemundodeletecreate 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-environments-environment_id-file_system-unfiled path: /api/environments/{environment_id}/file_system/unfiled/ operations: - name: environmentsfilesystemunfiledretrieve method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: api-environments-environment_id-file_system-id path: /api/environments/{environment_id}/file_system/{id}/ operations: - name: environmentsfilesystemretrieve method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: environmentsfilesystemupdate method: PUT description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: environmentsfilesystempartialupdate method: PATCH description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: environmentsfilesystemdestroy method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: api-environments-environment_id-file_system-id-count path: /api/environments/{environment_id}/file_system/{id}/count/ operations: - name: environmentsfilesystemcountcreate method: POST description: Get count of all files in a folder. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: api-environments-environment_id-file_system-id-link path: /api/environments/{environment_id}/file_system/{id}/link/ operations: - name: environmentsfilesystemlinkcreate method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: api-environments-environment_id-file_system-id-move path: /api/environments/{environment_id}/file_system/{id}/move/ operations: - name: environmentsfilesystemmovecreate method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: api-projects-project_id-file_system path: /api/projects/{project_id}/file_system/ operations: - name: filesystemlist method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: limit in: query type: integer description: Number of results to return per page. - name: offset in: query type: integer description: The initial index from which to return the results. - name: search in: query type: string description: A search term. - name: filesystemcreate 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-file_system-count_by_path path: /api/projects/{project_id}/file_system/count_by_path/ operations: - name: filesystemcountbypathcreate method: POST description: Get count of all files in a folder. 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-file_system-log_view path: /api/projects/{project_id}/file_system/log_view/ operations: - name: filesystemlogviewretrieve method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: filesystemlogviewcreate 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-file_system-undo_delete path: /api/projects/{project_id}/file_system/undo_delete/ operations: - name: filesystemundodeletecreate 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-file_system-unfiled path: /api/projects/{project_id}/file_system/unfiled/ operations: - name: filesystemunfiledretrieve method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. - name: api-projects-project_id-file_system-id path: /api/projects/{project_id}/file_system/{id}/ operations: - name: filesystemretrieve method: GET description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: filesystemupdate method: PUT description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: filesystempartialupdate method: PATCH description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: false - name: filesystemdestroy method: DELETE description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: api-projects-project_id-file_system-id-count path: /api/projects/{project_id}/file_system/{id}/count/ operations: - name: filesystemcountcreate method: POST description: Get count of all files in a folder. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: api-projects-project_id-file_system-id-link path: /api/projects/{project_id}/file_system/{id}/link/ operations: - name: filesystemlinkcreate method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. required: true - name: body in: body type: object description: Request body (JSON). required: true - name: api-projects-project_id-file_system-id-move path: /api/projects/{project_id}/file_system/{id}/move/ operations: - name: filesystemmovecreate method: POST description: '' outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: A UUID string identifying this file system. 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-file-system-rest port: 8080 description: REST adapter for PostHog API — file_system. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/api/environments/{environment-id}/file-system name: api-environments-environment-id-file-system description: REST surface for api-environments-environment_id-file_system. operations: - method: GET name: environmentsfilesystemlist description: environmentsfilesystemlist call: posthog-file-system.environmentsfilesystemlist with: limit: rest.limit offset: rest.offset search: rest.search outputParameters: - type: object mapping: $. - method: POST name: environmentsfilesystemcreate description: environmentsfilesystemcreate call: posthog-file-system.environmentsfilesystemcreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/count-by-path name: api-environments-environment-id-file-system-count-by-path description: REST surface for api-environments-environment_id-file_system-count_by_path. operations: - method: POST name: environmentsfilesystemcountbypathcreate description: Get count of all files in a folder. call: posthog-file-system.environmentsfilesystemcountbypathcreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/log-view name: api-environments-environment-id-file-system-log-view description: REST surface for api-environments-environment_id-file_system-log_view. operations: - method: GET name: environmentsfilesystemlogviewretrieve description: environmentsfilesystemlogviewretrieve call: posthog-file-system.environmentsfilesystemlogviewretrieve outputParameters: - type: object mapping: $. - method: POST name: environmentsfilesystemlogviewcreate description: environmentsfilesystemlogviewcreate call: posthog-file-system.environmentsfilesystemlogviewcreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/undo-delete name: api-environments-environment-id-file-system-undo-delete description: REST surface for api-environments-environment_id-file_system-undo_delete. operations: - method: POST name: environmentsfilesystemundodeletecreate description: environmentsfilesystemundodeletecreate call: posthog-file-system.environmentsfilesystemundodeletecreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/unfiled name: api-environments-environment-id-file-system-unfiled description: REST surface for api-environments-environment_id-file_system-unfiled. operations: - method: GET name: environmentsfilesystemunfiledretrieve description: environmentsfilesystemunfiledretrieve call: posthog-file-system.environmentsfilesystemunfiledretrieve outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/{id} name: api-environments-environment-id-file-system-id description: REST surface for api-environments-environment_id-file_system-id. operations: - method: GET name: environmentsfilesystemretrieve description: environmentsfilesystemretrieve call: posthog-file-system.environmentsfilesystemretrieve with: id: rest.id outputParameters: - type: object mapping: $. - method: PUT name: environmentsfilesystemupdate description: environmentsfilesystemupdate call: posthog-file-system.environmentsfilesystemupdate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: environmentsfilesystempartialupdate description: environmentsfilesystempartialupdate call: posthog-file-system.environmentsfilesystempartialupdate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: environmentsfilesystemdestroy description: environmentsfilesystemdestroy call: posthog-file-system.environmentsfilesystemdestroy with: id: rest.id outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/{id}/count name: api-environments-environment-id-file-system-id-count description: REST surface for api-environments-environment_id-file_system-id-count. operations: - method: POST name: environmentsfilesystemcountcreate description: Get count of all files in a folder. call: posthog-file-system.environmentsfilesystemcountcreate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/{id}/link name: api-environments-environment-id-file-system-id-link description: REST surface for api-environments-environment_id-file_system-id-link. operations: - method: POST name: environmentsfilesystemlinkcreate description: environmentsfilesystemlinkcreate call: posthog-file-system.environmentsfilesystemlinkcreate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/environments/{environment-id}/file-system/{id}/move name: api-environments-environment-id-file-system-id-move description: REST surface for api-environments-environment_id-file_system-id-move. operations: - method: POST name: environmentsfilesystemmovecreate description: environmentsfilesystemmovecreate call: posthog-file-system.environmentsfilesystemmovecreate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system name: api-projects-project-id-file-system description: REST surface for api-projects-project_id-file_system. operations: - method: GET name: filesystemlist description: filesystemlist call: posthog-file-system.filesystemlist with: limit: rest.limit offset: rest.offset search: rest.search outputParameters: - type: object mapping: $. - method: POST name: filesystemcreate description: filesystemcreate call: posthog-file-system.filesystemcreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/count-by-path name: api-projects-project-id-file-system-count-by-path description: REST surface for api-projects-project_id-file_system-count_by_path. operations: - method: POST name: filesystemcountbypathcreate description: Get count of all files in a folder. call: posthog-file-system.filesystemcountbypathcreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/log-view name: api-projects-project-id-file-system-log-view description: REST surface for api-projects-project_id-file_system-log_view. operations: - method: GET name: filesystemlogviewretrieve description: filesystemlogviewretrieve call: posthog-file-system.filesystemlogviewretrieve outputParameters: - type: object mapping: $. - method: POST name: filesystemlogviewcreate description: filesystemlogviewcreate call: posthog-file-system.filesystemlogviewcreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/undo-delete name: api-projects-project-id-file-system-undo-delete description: REST surface for api-projects-project_id-file_system-undo_delete. operations: - method: POST name: filesystemundodeletecreate description: filesystemundodeletecreate call: posthog-file-system.filesystemundodeletecreate with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/unfiled name: api-projects-project-id-file-system-unfiled description: REST surface for api-projects-project_id-file_system-unfiled. operations: - method: GET name: filesystemunfiledretrieve description: filesystemunfiledretrieve call: posthog-file-system.filesystemunfiledretrieve outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/{id} name: api-projects-project-id-file-system-id description: REST surface for api-projects-project_id-file_system-id. operations: - method: GET name: filesystemretrieve description: filesystemretrieve call: posthog-file-system.filesystemretrieve with: id: rest.id outputParameters: - type: object mapping: $. - method: PUT name: filesystemupdate description: filesystemupdate call: posthog-file-system.filesystemupdate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: filesystempartialupdate description: filesystempartialupdate call: posthog-file-system.filesystempartialupdate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: filesystemdestroy description: filesystemdestroy call: posthog-file-system.filesystemdestroy with: id: rest.id outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/{id}/count name: api-projects-project-id-file-system-id-count description: REST surface for api-projects-project_id-file_system-id-count. operations: - method: POST name: filesystemcountcreate description: Get count of all files in a folder. call: posthog-file-system.filesystemcountcreate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/{id}/link name: api-projects-project-id-file-system-id-link description: REST surface for api-projects-project_id-file_system-id-link. operations: - method: POST name: filesystemlinkcreate description: filesystemlinkcreate call: posthog-file-system.filesystemlinkcreate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - path: /v1/api/projects/{project-id}/file-system/{id}/move name: api-projects-project-id-file-system-id-move description: REST surface for api-projects-project_id-file_system-id-move. operations: - method: POST name: filesystemmovecreate description: filesystemmovecreate call: posthog-file-system.filesystemmovecreate with: id: rest.id body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: posthog-file-system-mcp port: 9090 transport: http description: MCP adapter for PostHog API — file_system. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: environmentsfilesystemlist description: environmentsfilesystemlist hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.environmentsfilesystemlist with: limit: tools.limit offset: tools.offset search: tools.search outputParameters: - type: object mapping: $. - name: environmentsfilesystemcreate description: environmentsfilesystemcreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemcreate with: body: tools.body outputParameters: - type: object mapping: $. - name: get-count-all-files-folder description: Get count of all files in a folder. hints: readOnly: true destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemcountbypathcreate with: body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystemlogviewretrieve description: environmentsfilesystemlogviewretrieve hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.environmentsfilesystemlogviewretrieve outputParameters: - type: object mapping: $. - name: environmentsfilesystemlogviewcreate description: environmentsfilesystemlogviewcreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemlogviewcreate with: body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystemundodeletecreate description: environmentsfilesystemundodeletecreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemundodeletecreate with: body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystemunfiledretrieve description: environmentsfilesystemunfiledretrieve hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.environmentsfilesystemunfiledretrieve outputParameters: - type: object mapping: $. - name: environmentsfilesystemretrieve description: environmentsfilesystemretrieve hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.environmentsfilesystemretrieve with: id: tools.id outputParameters: - type: object mapping: $. - name: environmentsfilesystemupdate description: environmentsfilesystemupdate hints: readOnly: false destructive: false idempotent: true call: posthog-file-system.environmentsfilesystemupdate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystempartialupdate description: environmentsfilesystempartialupdate hints: readOnly: false destructive: false idempotent: true call: posthog-file-system.environmentsfilesystempartialupdate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystemdestroy description: environmentsfilesystemdestroy hints: readOnly: false destructive: true idempotent: true call: posthog-file-system.environmentsfilesystemdestroy with: id: tools.id outputParameters: - type: object mapping: $. - name: get-count-all-files-folder-2 description: Get count of all files in a folder. hints: readOnly: true destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemcountcreate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystemlinkcreate description: environmentsfilesystemlinkcreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemlinkcreate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: environmentsfilesystemmovecreate description: environmentsfilesystemmovecreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.environmentsfilesystemmovecreate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: filesystemlist description: filesystemlist hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.filesystemlist with: limit: tools.limit offset: tools.offset search: tools.search outputParameters: - type: object mapping: $. - name: filesystemcreate description: filesystemcreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.filesystemcreate with: body: tools.body outputParameters: - type: object mapping: $. - name: get-count-all-files-folder-3 description: Get count of all files in a folder. hints: readOnly: true destructive: false idempotent: false call: posthog-file-system.filesystemcountbypathcreate with: body: tools.body outputParameters: - type: object mapping: $. - name: filesystemlogviewretrieve description: filesystemlogviewretrieve hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.filesystemlogviewretrieve outputParameters: - type: object mapping: $. - name: filesystemlogviewcreate description: filesystemlogviewcreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.filesystemlogviewcreate with: body: tools.body outputParameters: - type: object mapping: $. - name: filesystemundodeletecreate description: filesystemundodeletecreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.filesystemundodeletecreate with: body: tools.body outputParameters: - type: object mapping: $. - name: filesystemunfiledretrieve description: filesystemunfiledretrieve hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.filesystemunfiledretrieve outputParameters: - type: object mapping: $. - name: filesystemretrieve description: filesystemretrieve hints: readOnly: true destructive: false idempotent: true call: posthog-file-system.filesystemretrieve with: id: tools.id outputParameters: - type: object mapping: $. - name: filesystemupdate description: filesystemupdate hints: readOnly: false destructive: false idempotent: true call: posthog-file-system.filesystemupdate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: filesystempartialupdate description: filesystempartialupdate hints: readOnly: false destructive: false idempotent: true call: posthog-file-system.filesystempartialupdate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: filesystemdestroy description: filesystemdestroy hints: readOnly: false destructive: true idempotent: true call: posthog-file-system.filesystemdestroy with: id: tools.id outputParameters: - type: object mapping: $. - name: get-count-all-files-folder-4 description: Get count of all files in a folder. hints: readOnly: true destructive: false idempotent: false call: posthog-file-system.filesystemcountcreate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: filesystemlinkcreate description: filesystemlinkcreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.filesystemlinkcreate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $. - name: filesystemmovecreate description: filesystemmovecreate hints: readOnly: false destructive: false idempotent: false call: posthog-file-system.filesystemmovecreate with: id: tools.id body: tools.body outputParameters: - type: object mapping: $.