naftiko: 1.0.0-alpha2 info: label: GitHub v3 REST API — Apps description: 'GitHub v3 REST API — Apps. 29 operations. Lead operation: GitHub Get the Authenticated App. Self-contained Naftiko capability covering one Github business surface.' tags: - Github - Apps created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: GITHUB_API_KEY: GITHUB_API_KEY capability: consumes: - type: http namespace: github-apps baseUri: '' description: GitHub v3 REST API — Apps business capability. Self-contained, no shared references. resources: - name: app path: /app operations: - name: appsgetauthenticated method: GET description: GitHub Get the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: app-manifests-code-conversions path: /app-manifests/{code}/conversions operations: - name: appscreatefrommanifest method: POST description: GitHub Create a GitHub App from a Manifest outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: code in: path type: string required: true - name: app-hook-config path: /app/hook/config operations: - name: appsgetwebhookconfigforapp method: GET description: GitHub Get a Webhook Configuration for an App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: appsupdatewebhookconfigforapp method: PATCH description: GitHub Update a Webhook Configuration for an App outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: app-hook-deliveries path: /app/hook/deliveries operations: - name: appslistwebhookdeliveries method: GET description: GitHub List Deliveries for an App Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: redelivery in: query type: boolean - name: app-hook-deliveries-delivery_id path: /app/hook/deliveries/{delivery_id} operations: - name: appsgetwebhookdelivery method: GET description: GitHub Get a Delivery for an App Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. - name: app-hook-deliveries-delivery_id-attempts path: /app/hook/deliveries/{delivery_id}/attempts operations: - name: appsredeliverwebhookdelivery method: POST description: GitHub Redeliver a Delivery for an App Webhook outputRawFormat: json outputParameters: - name: result type: object value: $. - name: app-installation-requests path: /app/installation-requests operations: - name: appslistinstallationrequestsforauthenticatedapp method: GET description: GitHub List Installation Requests for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: app-installations path: /app/installations operations: - name: appslistinstallations method: GET description: GitHub List Installations for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: outdated in: query type: string - name: app-installations-installation_id path: /app/installations/{installation_id} operations: - name: appsgetinstallation method: GET description: GitHub Get an Installation for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: appsdeleteinstallation method: DELETE description: GitHub Delete an Installation for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: app-installations-installation_id-access_tokens path: /app/installations/{installation_id}/access_tokens operations: - name: appscreateinstallationaccesstoken method: POST description: GitHub Create an Installation Access Token for an App outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: false - name: app-installations-installation_id-suspended path: /app/installations/{installation_id}/suspended operations: - name: appssuspendinstallation method: PUT description: GitHub Suspend an App Installation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: appsunsuspendinstallation method: DELETE description: GitHub Unsuspend an App Installation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: applications-client_id-grant path: /applications/{client_id}/grant operations: - name: appsdeleteauthorization method: DELETE description: GitHub Delete an App Authorization outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: applications-client_id-token path: /applications/{client_id}/token operations: - name: appschecktoken method: POST description: GitHub Check a Token outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: appsresettoken method: PATCH description: GitHub Reset a Token outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: appsdeletetoken method: DELETE description: GitHub Delete an App Token outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: applications-client_id-token-scoped path: /applications/{client_id}/token/scoped operations: - name: appsscopetoken method: POST description: GitHub Create a Scoped Access Token outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: apps-app_slug path: /apps/{app_slug} operations: - name: appsgetbyslug method: GET description: GitHub Get an App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: installation-repositories path: /installation/repositories operations: - name: appslistreposaccessibletoinstallation method: GET description: GitHub List Repositories Accessible to the App Installation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: installation-token path: /installation/token operations: - name: appsrevokeinstallationaccesstoken method: DELETE description: GitHub Revoke an Installation Access Token outputRawFormat: json outputParameters: - name: result type: object value: $. - name: orgs-org-installation path: /orgs/{org}/installation operations: - name: appsgetorginstallation method: GET description: GitHub Get an Organization Installation for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: repos-owner-repo-installation path: /repos/{owner}/{repo}/installation operations: - name: appsgetrepoinstallation method: GET description: GitHub Get a Repository Installation for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. - name: user-installations path: /user/installations operations: - name: appslistinstallationsforauthenticateduser method: GET description: GitHub List App Installations Accessible to the User Access Token outputRawFormat: json outputParameters: - name: result type: object value: $. - name: user-installations-installation_id-repositories path: /user/installations/{installation_id}/repositories operations: - name: appslistinstallationreposforauthenticateduser method: GET description: GitHub List Repositories Accessible to the User Access Token outputRawFormat: json outputParameters: - name: result type: object value: $. - name: user-installations-installation_id-repositories-repository_id path: /user/installations/{installation_id}/repositories/{repository_id} operations: - name: appsaddrepotoinstallationforauthenticateduser method: PUT description: GitHub Add a Repository to an App Installation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: appsremoverepofrominstallationforauthenticateduser method: DELETE description: GitHub Remove a Repository from an App Installation outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-username-installation path: /users/{username}/installation operations: - name: appsgetuserinstallation method: GET description: GitHub Get a User Installation for the Authenticated App outputRawFormat: json outputParameters: - name: result type: object value: $. exposes: - type: rest namespace: github-apps-rest port: 8080 description: REST adapter for GitHub v3 REST API — Apps. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/app name: app description: REST surface for app. operations: - method: GET name: appsgetauthenticated description: GitHub Get the Authenticated App call: github-apps.appsgetauthenticated outputParameters: - type: object mapping: $. - path: /v1/app-manifests/{code}/conversions name: app-manifests-code-conversions description: REST surface for app-manifests-code-conversions. operations: - method: POST name: appscreatefrommanifest description: GitHub Create a GitHub App from a Manifest call: github-apps.appscreatefrommanifest with: code: rest.code outputParameters: - type: object mapping: $. - path: /v1/app/hook/config name: app-hook-config description: REST surface for app-hook-config. operations: - method: GET name: appsgetwebhookconfigforapp description: GitHub Get a Webhook Configuration for an App call: github-apps.appsgetwebhookconfigforapp outputParameters: - type: object mapping: $. - method: PATCH name: appsupdatewebhookconfigforapp description: GitHub Update a Webhook Configuration for an App call: github-apps.appsupdatewebhookconfigforapp with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/app/hook/deliveries name: app-hook-deliveries description: REST surface for app-hook-deliveries. operations: - method: GET name: appslistwebhookdeliveries description: GitHub List Deliveries for an App Webhook call: github-apps.appslistwebhookdeliveries with: redelivery: rest.redelivery outputParameters: - type: object mapping: $. - path: /v1/app/hook/deliveries/{delivery-id} name: app-hook-deliveries-delivery-id description: REST surface for app-hook-deliveries-delivery_id. operations: - method: GET name: appsgetwebhookdelivery description: GitHub Get a Delivery for an App Webhook call: github-apps.appsgetwebhookdelivery outputParameters: - type: object mapping: $. - path: /v1/app/hook/deliveries/{delivery-id}/attempts name: app-hook-deliveries-delivery-id-attempts description: REST surface for app-hook-deliveries-delivery_id-attempts. operations: - method: POST name: appsredeliverwebhookdelivery description: GitHub Redeliver a Delivery for an App Webhook call: github-apps.appsredeliverwebhookdelivery outputParameters: - type: object mapping: $. - path: /v1/app/installation-requests name: app-installation-requests description: REST surface for app-installation-requests. operations: - method: GET name: appslistinstallationrequestsforauthenticatedapp description: GitHub List Installation Requests for the Authenticated App call: github-apps.appslistinstallationrequestsforauthenticatedapp outputParameters: - type: object mapping: $. - path: /v1/app/installations name: app-installations description: REST surface for app-installations. operations: - method: GET name: appslistinstallations description: GitHub List Installations for the Authenticated App call: github-apps.appslistinstallations with: outdated: rest.outdated outputParameters: - type: object mapping: $. - path: /v1/app/installations/{installation-id} name: app-installations-installation-id description: REST surface for app-installations-installation_id. operations: - method: GET name: appsgetinstallation description: GitHub Get an Installation for the Authenticated App call: github-apps.appsgetinstallation outputParameters: - type: object mapping: $. - method: DELETE name: appsdeleteinstallation description: GitHub Delete an Installation for the Authenticated App call: github-apps.appsdeleteinstallation outputParameters: - type: object mapping: $. - path: /v1/app/installations/{installation-id}/access-tokens name: app-installations-installation-id-access-tokens description: REST surface for app-installations-installation_id-access_tokens. operations: - method: POST name: appscreateinstallationaccesstoken description: GitHub Create an Installation Access Token for an App call: github-apps.appscreateinstallationaccesstoken with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/app/installations/{installation-id}/suspended name: app-installations-installation-id-suspended description: REST surface for app-installations-installation_id-suspended. operations: - method: PUT name: appssuspendinstallation description: GitHub Suspend an App Installation call: github-apps.appssuspendinstallation outputParameters: - type: object mapping: $. - method: DELETE name: appsunsuspendinstallation description: GitHub Unsuspend an App Installation call: github-apps.appsunsuspendinstallation outputParameters: - type: object mapping: $. - path: /v1/applications/{client-id}/grant name: applications-client-id-grant description: REST surface for applications-client_id-grant. operations: - method: DELETE name: appsdeleteauthorization description: GitHub Delete an App Authorization call: github-apps.appsdeleteauthorization with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/applications/{client-id}/token name: applications-client-id-token description: REST surface for applications-client_id-token. operations: - method: POST name: appschecktoken description: GitHub Check a Token call: github-apps.appschecktoken with: body: rest.body outputParameters: - type: object mapping: $. - method: PATCH name: appsresettoken description: GitHub Reset a Token call: github-apps.appsresettoken with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: appsdeletetoken description: GitHub Delete an App Token call: github-apps.appsdeletetoken with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/applications/{client-id}/token/scoped name: applications-client-id-token-scoped description: REST surface for applications-client_id-token-scoped. operations: - method: POST name: appsscopetoken description: GitHub Create a Scoped Access Token call: github-apps.appsscopetoken with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/apps/{app-slug} name: apps-app-slug description: REST surface for apps-app_slug. operations: - method: GET name: appsgetbyslug description: GitHub Get an App call: github-apps.appsgetbyslug outputParameters: - type: object mapping: $. - path: /v1/installation/repositories name: installation-repositories description: REST surface for installation-repositories. operations: - method: GET name: appslistreposaccessibletoinstallation description: GitHub List Repositories Accessible to the App Installation call: github-apps.appslistreposaccessibletoinstallation outputParameters: - type: object mapping: $. - path: /v1/installation/token name: installation-token description: REST surface for installation-token. operations: - method: DELETE name: appsrevokeinstallationaccesstoken description: GitHub Revoke an Installation Access Token call: github-apps.appsrevokeinstallationaccesstoken outputParameters: - type: object mapping: $. - path: /v1/orgs/{org}/installation name: orgs-org-installation description: REST surface for orgs-org-installation. operations: - method: GET name: appsgetorginstallation description: GitHub Get an Organization Installation for the Authenticated App call: github-apps.appsgetorginstallation outputParameters: - type: object mapping: $. - path: /v1/repos/{owner}/{repo}/installation name: repos-owner-repo-installation description: REST surface for repos-owner-repo-installation. operations: - method: GET name: appsgetrepoinstallation description: GitHub Get a Repository Installation for the Authenticated App call: github-apps.appsgetrepoinstallation outputParameters: - type: object mapping: $. - path: /v1/user/installations name: user-installations description: REST surface for user-installations. operations: - method: GET name: appslistinstallationsforauthenticateduser description: GitHub List App Installations Accessible to the User Access Token call: github-apps.appslistinstallationsforauthenticateduser outputParameters: - type: object mapping: $. - path: /v1/user/installations/{installation-id}/repositories name: user-installations-installation-id-repositories description: REST surface for user-installations-installation_id-repositories. operations: - method: GET name: appslistinstallationreposforauthenticateduser description: GitHub List Repositories Accessible to the User Access Token call: github-apps.appslistinstallationreposforauthenticateduser outputParameters: - type: object mapping: $. - path: /v1/user/installations/{installation-id}/repositories/{repository-id} name: user-installations-installation-id-repositories-repository-id description: REST surface for user-installations-installation_id-repositories-repository_id. operations: - method: PUT name: appsaddrepotoinstallationforauthenticateduser description: GitHub Add a Repository to an App Installation call: github-apps.appsaddrepotoinstallationforauthenticateduser outputParameters: - type: object mapping: $. - method: DELETE name: appsremoverepofrominstallationforauthenticateduser description: GitHub Remove a Repository from an App Installation call: github-apps.appsremoverepofrominstallationforauthenticateduser outputParameters: - type: object mapping: $. - path: /v1/users/{username}/installation name: users-username-installation description: REST surface for users-username-installation. operations: - method: GET name: appsgetuserinstallation description: GitHub Get a User Installation for the Authenticated App call: github-apps.appsgetuserinstallation outputParameters: - type: object mapping: $. - type: mcp namespace: github-apps-mcp port: 9090 transport: http description: MCP adapter for GitHub v3 REST API — Apps. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: github-get-authenticated-app description: GitHub Get the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetauthenticated outputParameters: - type: object mapping: $. - name: github-create-github-app-manifest description: GitHub Create a GitHub App from a Manifest hints: readOnly: false destructive: false idempotent: false call: github-apps.appscreatefrommanifest with: code: tools.code outputParameters: - type: object mapping: $. - name: github-get-webhook-configuration-app description: GitHub Get a Webhook Configuration for an App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetwebhookconfigforapp outputParameters: - type: object mapping: $. - name: github-update-webhook-configuration-app description: GitHub Update a Webhook Configuration for an App hints: readOnly: false destructive: false idempotent: true call: github-apps.appsupdatewebhookconfigforapp with: body: tools.body outputParameters: - type: object mapping: $. - name: github-list-deliveries-app-webhook description: GitHub List Deliveries for an App Webhook hints: readOnly: true destructive: false idempotent: true call: github-apps.appslistwebhookdeliveries with: redelivery: tools.redelivery outputParameters: - type: object mapping: $. - name: github-get-delivery-app-webhook description: GitHub Get a Delivery for an App Webhook hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetwebhookdelivery outputParameters: - type: object mapping: $. - name: github-redeliver-delivery-app-webhook description: GitHub Redeliver a Delivery for an App Webhook hints: readOnly: false destructive: false idempotent: false call: github-apps.appsredeliverwebhookdelivery outputParameters: - type: object mapping: $. - name: github-list-installation-requests-authenticated description: GitHub List Installation Requests for the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appslistinstallationrequestsforauthenticatedapp outputParameters: - type: object mapping: $. - name: github-list-installations-authenticated-app description: GitHub List Installations for the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appslistinstallations with: outdated: tools.outdated outputParameters: - type: object mapping: $. - name: github-get-installation-authenticated-app description: GitHub Get an Installation for the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetinstallation outputParameters: - type: object mapping: $. - name: github-delete-installation-authenticated-app description: GitHub Delete an Installation for the Authenticated App hints: readOnly: false destructive: true idempotent: true call: github-apps.appsdeleteinstallation outputParameters: - type: object mapping: $. - name: github-create-installation-access-token description: GitHub Create an Installation Access Token for an App hints: readOnly: false destructive: false idempotent: false call: github-apps.appscreateinstallationaccesstoken with: body: tools.body outputParameters: - type: object mapping: $. - name: github-suspend-app-installation description: GitHub Suspend an App Installation hints: readOnly: false destructive: false idempotent: true call: github-apps.appssuspendinstallation outputParameters: - type: object mapping: $. - name: github-unsuspend-app-installation description: GitHub Unsuspend an App Installation hints: readOnly: false destructive: true idempotent: true call: github-apps.appsunsuspendinstallation outputParameters: - type: object mapping: $. - name: github-delete-app-authorization description: GitHub Delete an App Authorization hints: readOnly: false destructive: true idempotent: true call: github-apps.appsdeleteauthorization with: body: tools.body outputParameters: - type: object mapping: $. - name: github-check-token description: GitHub Check a Token hints: readOnly: true destructive: false idempotent: false call: github-apps.appschecktoken with: body: tools.body outputParameters: - type: object mapping: $. - name: github-reset-token description: GitHub Reset a Token hints: readOnly: false destructive: false idempotent: true call: github-apps.appsresettoken with: body: tools.body outputParameters: - type: object mapping: $. - name: github-delete-app-token description: GitHub Delete an App Token hints: readOnly: false destructive: true idempotent: true call: github-apps.appsdeletetoken with: body: tools.body outputParameters: - type: object mapping: $. - name: github-create-scoped-access-token description: GitHub Create a Scoped Access Token hints: readOnly: false destructive: false idempotent: false call: github-apps.appsscopetoken with: body: tools.body outputParameters: - type: object mapping: $. - name: github-get-app description: GitHub Get an App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetbyslug outputParameters: - type: object mapping: $. - name: github-list-repositories-accessible-app description: GitHub List Repositories Accessible to the App Installation hints: readOnly: true destructive: false idempotent: true call: github-apps.appslistreposaccessibletoinstallation outputParameters: - type: object mapping: $. - name: github-revoke-installation-access-token description: GitHub Revoke an Installation Access Token hints: readOnly: false destructive: true idempotent: true call: github-apps.appsrevokeinstallationaccesstoken outputParameters: - type: object mapping: $. - name: github-get-organization-installation-authenticated description: GitHub Get an Organization Installation for the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetorginstallation outputParameters: - type: object mapping: $. - name: github-get-repository-installation-authenticated description: GitHub Get a Repository Installation for the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetrepoinstallation outputParameters: - type: object mapping: $. - name: github-list-app-installations-accessible description: GitHub List App Installations Accessible to the User Access Token hints: readOnly: true destructive: false idempotent: true call: github-apps.appslistinstallationsforauthenticateduser outputParameters: - type: object mapping: $. - name: github-list-repositories-accessible-user description: GitHub List Repositories Accessible to the User Access Token hints: readOnly: true destructive: false idempotent: true call: github-apps.appslistinstallationreposforauthenticateduser outputParameters: - type: object mapping: $. - name: github-add-repository-app-installation description: GitHub Add a Repository to an App Installation hints: readOnly: false destructive: false idempotent: true call: github-apps.appsaddrepotoinstallationforauthenticateduser outputParameters: - type: object mapping: $. - name: github-remove-repository-app-installation description: GitHub Remove a Repository from an App Installation hints: readOnly: false destructive: true idempotent: true call: github-apps.appsremoverepofrominstallationforauthenticateduser outputParameters: - type: object mapping: $. - name: github-get-user-installation-authenticated description: GitHub Get a User Installation for the Authenticated App hints: readOnly: true destructive: false idempotent: true call: github-apps.appsgetuserinstallation outputParameters: - type: object mapping: $.