GitHub Copilot REST API

naftiko: 1.0.0-alpha2
info:
  label: GitHub Copilot REST API
  description: REST API for managing GitHub Copilot seat assignments, billing, usage metrics, content exclusion rules, and
    organizational settings. Covers user management, aggregated metrics, usage reports, and content governance across organizations
    and enterprises.
  tags:
  - Github
  - Copilot
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: github-copilot
    baseUri: https://api.github.com
    description: GitHub Copilot REST API HTTP API.
    authentication:
      type: bearer
      token: '{{GITHUB_COPILOT_TOKEN}}'
    resources:
    - name: orgs-org-copilot-billing
      path: /orgs/{org}/copilot/billing
      operations:
      - name: getcopilotbillingfororganization
        method: GET
        description: Github Copilot Get Copilot Billing Information for an Organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-billing-seats
      path: /orgs/{org}/copilot/billing/seats
      operations:
      - name: listcopilotseats
        method: GET
        description: Github Copilot List All Copilot Seat Assignments for an Organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-billing-selected-teams
      path: /orgs/{org}/copilot/billing/selected_teams
      operations:
      - name: addteamstocopilotsubscription
        method: POST
        description: Github Copilot Add Teams to Copilot Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: removeteamsfromcopilotsubscription
        method: DELETE
        description: Github Copilot Remove Teams From Copilot Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-billing-selected-users
      path: /orgs/{org}/copilot/billing/selected_users
      operations:
      - name: adduserstocopilotsubscription
        method: POST
        description: Github Copilot Add Users to Copilot Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: removeusersfromcopilotsubscription
        method: DELETE
        description: Github Copilot Remove Users From Copilot Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-members-username-copilot
      path: /orgs/{org}/members/{username}/copilot
      operations:
      - name: getcopilotseatforuser
        method: GET
        description: Github Copilot Get Copilot Seat Assignment Details for a User
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-metrics
      path: /orgs/{org}/copilot/metrics
      operations:
      - name: getcopilotmetricsfororganization
        method: GET
        description: Github Copilot Get Copilot Metrics for an Organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-team-team-slug-copilot-metrics
      path: /orgs/{org}/team/{team_slug}/copilot/metrics
      operations:
      - name: getcopilotmetricsforteam
        method: GET
        description: Github Copilot Get Copilot Metrics for a Team
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: enterprises-enterprise-copilot-metrics-reports-e
      path: /enterprises/{enterprise}/copilot/metrics/reports/enterprise-1-day
      operations:
      - name: getenterprisecopilotusagedaily
        method: GET
        description: Github Copilot Get Enterprise Copilot Usage Metrics for a Specific Day
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: enterprises-enterprise-copilot-metrics-reports-e
      path: /enterprises/{enterprise}/copilot/metrics/reports/enterprise-28-day/latest
      operations:
      - name: getenterprisecopilotusage28day
        method: GET
        description: Github Copilot Get Latest 28-day Enterprise Copilot Usage Metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: enterprises-enterprise-copilot-metrics-reports-u
      path: /enterprises/{enterprise}/copilot/metrics/reports/users-1-day
      operations:
      - name: getenterpriseuserscopilotusagedaily
        method: GET
        description: Github Copilot Get Enterprise User-level Copilot Usage Metrics for a Specific Day
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: enterprises-enterprise-copilot-metrics-reports-u
      path: /enterprises/{enterprise}/copilot/metrics/reports/users-28-day/latest
      operations:
      - name: getenterpriseuserscopilotusage28day
        method: GET
        description: Github Copilot Get Latest 28-day Enterprise User-level Copilot Usage Metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-metrics-reports-organization-1-
      path: /orgs/{org}/copilot/metrics/reports/organization-1-day
      operations:
      - name: getorganizationcopilotusagedaily
        method: GET
        description: Github Copilot Get Organization Copilot Usage Metrics for a Specific Day
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-metrics-reports-organization-28
      path: /orgs/{org}/copilot/metrics/reports/organization-28-day/latest
      operations:
      - name: getorganizationcopilotusage28day
        method: GET
        description: Github Copilot Get Latest 28-day Organization Copilot Usage Metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-metrics-reports-users-1-day
      path: /orgs/{org}/copilot/metrics/reports/users-1-day
      operations:
      - name: getorganizationuserscopilotusagedaily
        method: GET
        description: Github Copilot Get Organization User-level Copilot Usage Metrics for a Specific Day
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-metrics-reports-users-28-day-la
      path: /orgs/{org}/copilot/metrics/reports/users-28-day/latest
      operations:
      - name: getorganizationuserscopilotusage28day
        method: GET
        description: Github Copilot Get Latest 28-day Organization User-level Copilot Usage Metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: orgs-org-copilot-content-exclusion
      path: /orgs/{org}/copilot/content_exclusion
      operations:
      - name: getcopilotcontentexclusionrules
        method: GET
        description: Github Copilot Get Copilot Content Exclusion Rules for an Organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: setcopilotcontentexclusionrules
        method: PUT
        description: Github Copilot Set Copilot Content Exclusion Rules for an Organization
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: github-copilot-rest
    description: REST adapter for GitHub Copilot REST API.
    resources:
    - path: /orgs/{org}/copilot/billing
      name: getcopilotbillingfororganization
      operations:
      - method: GET
        name: getcopilotbillingfororganization
        description: Github Copilot Get Copilot Billing Information for an Organization
        call: github-copilot.getcopilotbillingfororganization
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/billing/seats
      name: listcopilotseats
      operations:
      - method: GET
        name: listcopilotseats
        description: Github Copilot List All Copilot Seat Assignments for an Organization
        call: github-copilot.listcopilotseats
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/billing/selected_teams
      name: addteamstocopilotsubscription
      operations:
      - method: POST
        name: addteamstocopilotsubscription
        description: Github Copilot Add Teams to Copilot Subscription
        call: github-copilot.addteamstocopilotsubscription
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/billing/selected_teams
      name: removeteamsfromcopilotsubscription
      operations:
      - method: DELETE
        name: removeteamsfromcopilotsubscription
        description: Github Copilot Remove Teams From Copilot Subscription
        call: github-copilot.removeteamsfromcopilotsubscription
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/billing/selected_users
      name: adduserstocopilotsubscription
      operations:
      - method: POST
        name: adduserstocopilotsubscription
        description: Github Copilot Add Users to Copilot Subscription
        call: github-copilot.adduserstocopilotsubscription
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/billing/selected_users
      name: removeusersfromcopilotsubscription
      operations:
      - method: DELETE
        name: removeusersfromcopilotsubscription
        description: Github Copilot Remove Users From Copilot Subscription
        call: github-copilot.removeusersfromcopilotsubscription
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/members/{username}/copilot
      name: getcopilotseatforuser
      operations:
      - method: GET
        name: getcopilotseatforuser
        description: Github Copilot Get Copilot Seat Assignment Details for a User
        call: github-copilot.getcopilotseatforuser
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/metrics
      name: getcopilotmetricsfororganization
      operations:
      - method: GET
        name: getcopilotmetricsfororganization
        description: Github Copilot Get Copilot Metrics for an Organization
        call: github-copilot.getcopilotmetricsfororganization
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/team/{team_slug}/copilot/metrics
      name: getcopilotmetricsforteam
      operations:
      - method: GET
        name: getcopilotmetricsforteam
        description: Github Copilot Get Copilot Metrics for a Team
        call: github-copilot.getcopilotmetricsforteam
        outputParameters:
        - type: object
          mapping: $.
    - path: /enterprises/{enterprise}/copilot/metrics/reports/enterprise-1-day
      name: getenterprisecopilotusagedaily
      operations:
      - method: GET
        name: getenterprisecopilotusagedaily
        description: Github Copilot Get Enterprise Copilot Usage Metrics for a Specific Day
        call: github-copilot.getenterprisecopilotusagedaily
        outputParameters:
        - type: object
          mapping: $.
    - path: /enterprises/{enterprise}/copilot/metrics/reports/enterprise-28-day/latest
      name: getenterprisecopilotusage28day
      operations:
      - method: GET
        name: getenterprisecopilotusage28day
        description: Github Copilot Get Latest 28-day Enterprise Copilot Usage Metrics
        call: github-copilot.getenterprisecopilotusage28day
        outputParameters:
        - type: object
          mapping: $.
    - path: /enterprises/{enterprise}/copilot/metrics/reports/users-1-day
      name: getenterpriseuserscopilotusagedaily
      operations:
      - method: GET
        name: getenterpriseuserscopilotusagedaily
        description: Github Copilot Get Enterprise User-level Copilot Usage Metrics for a Specific Day
        call: github-copilot.getenterpriseuserscopilotusagedaily
        outputParameters:
        - type: object
          mapping: $.
    - path: /enterprises/{enterprise}/copilot/metrics/reports/users-28-day/latest
      name: getenterpriseuserscopilotusage28day
      operations:
      - method: GET
        name: getenterpriseuserscopilotusage28day
        description: Github Copilot Get Latest 28-day Enterprise User-level Copilot Usage Metrics
        call: github-copilot.getenterpriseuserscopilotusage28day
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/metrics/reports/organization-1-day
      name: getorganizationcopilotusagedaily
      operations:
      - method: GET
        name: getorganizationcopilotusagedaily
        description: Github Copilot Get Organization Copilot Usage Metrics for a Specific Day
        call: github-copilot.getorganizationcopilotusagedaily
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/metrics/reports/organization-28-day/latest
      name: getorganizationcopilotusage28day
      operations:
      - method: GET
        name: getorganizationcopilotusage28day
        description: Github Copilot Get Latest 28-day Organization Copilot Usage Metrics
        call: github-copilot.getorganizationcopilotusage28day
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/metrics/reports/users-1-day
      name: getorganizationuserscopilotusagedaily
      operations:
      - method: GET
        name: getorganizationuserscopilotusagedaily
        description: Github Copilot Get Organization User-level Copilot Usage Metrics for a Specific Day
        call: github-copilot.getorganizationuserscopilotusagedaily
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/metrics/reports/users-28-day/latest
      name: getorganizationuserscopilotusage28day
      operations:
      - method: GET
        name: getorganizationuserscopilotusage28day
        description: Github Copilot Get Latest 28-day Organization User-level Copilot Usage Metrics
        call: github-copilot.getorganizationuserscopilotusage28day
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/content_exclusion
      name: getcopilotcontentexclusionrules
      operations:
      - method: GET
        name: getcopilotcontentexclusionrules
        description: Github Copilot Get Copilot Content Exclusion Rules for an Organization
        call: github-copilot.getcopilotcontentexclusionrules
        outputParameters:
        - type: object
          mapping: $.
    - path: /orgs/{org}/copilot/content_exclusion
      name: setcopilotcontentexclusionrules
      operations:
      - method: PUT
        name: setcopilotcontentexclusionrules
        description: Github Copilot Set Copilot Content Exclusion Rules for an Organization
        call: github-copilot.setcopilotcontentexclusionrules
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: github-copilot-mcp
    transport: http
    description: MCP adapter for GitHub Copilot REST API for AI agent use.
    tools:
    - name: getcopilotbillingfororganization
      description: Github Copilot Get Copilot Billing Information for an Organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getcopilotbillingfororganization
      outputParameters:
      - type: object
        mapping: $.
    - name: listcopilotseats
      description: Github Copilot List All Copilot Seat Assignments for an Organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.listcopilotseats
      outputParameters:
      - type: object
        mapping: $.
    - name: addteamstocopilotsubscription
      description: Github Copilot Add Teams to Copilot Subscription
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: github-copilot.addteamstocopilotsubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: removeteamsfromcopilotsubscription
      description: Github Copilot Remove Teams From Copilot Subscription
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-copilot.removeteamsfromcopilotsubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: adduserstocopilotsubscription
      description: Github Copilot Add Users to Copilot Subscription
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: github-copilot.adduserstocopilotsubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: removeusersfromcopilotsubscription
      description: Github Copilot Remove Users From Copilot Subscription
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: github-copilot.removeusersfromcopilotsubscription
      outputParameters:
      - type: object
        mapping: $.
    - name: getcopilotseatforuser
      description: Github Copilot Get Copilot Seat Assignment Details for a User
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getcopilotseatforuser
      outputParameters:
      - type: object
        mapping: $.
    - name: getcopilotmetricsfororganization
      description: Github Copilot Get Copilot Metrics for an Organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getcopilotmetricsfororganization
      outputParameters:
      - type: object
        mapping: $.
    - name: getcopilotmetricsforteam
      description: Github Copilot Get Copilot Metrics for a Team
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getcopilotmetricsforteam
      outputParameters:
      - type: object
        mapping: $.
    - name: getenterprisecopilotusagedaily
      description: Github Copilot Get Enterprise Copilot Usage Metrics for a Specific Day
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getenterprisecopilotusagedaily
      outputParameters:
      - type: object
        mapping: $.
    - name: getenterprisecopilotusage28day
      description: Github Copilot Get Latest 28-day Enterprise Copilot Usage Metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getenterprisecopilotusage28day
      outputParameters:
      - type: object
        mapping: $.
    - name: getenterpriseuserscopilotusagedaily
      description: Github Copilot Get Enterprise User-level Copilot Usage Metrics for a Specific Day
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getenterpriseuserscopilotusagedaily
      outputParameters:
      - type: object
        mapping: $.
    - name: getenterpriseuserscopilotusage28day
      description: Github Copilot Get Latest 28-day Enterprise User-level Copilot Usage Metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getenterpriseuserscopilotusage28day
      outputParameters:
      - type: object
        mapping: $.
    - name: getorganizationcopilotusagedaily
      description: Github Copilot Get Organization Copilot Usage Metrics for a Specific Day
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getorganizationcopilotusagedaily
      outputParameters:
      - type: object
        mapping: $.
    - name: getorganizationcopilotusage28day
      description: Github Copilot Get Latest 28-day Organization Copilot Usage Metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getorganizationcopilotusage28day
      outputParameters:
      - type: object
        mapping: $.
    - name: getorganizationuserscopilotusagedaily
      description: Github Copilot Get Organization User-level Copilot Usage Metrics for a Specific Day
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getorganizationuserscopilotusagedaily
      outputParameters:
      - type: object
        mapping: $.
    - name: getorganizationuserscopilotusage28day
      description: Github Copilot Get Latest 28-day Organization User-level Copilot Usage Metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getorganizationuserscopilotusage28day
      outputParameters:
      - type: object
        mapping: $.
    - name: getcopilotcontentexclusionrules
      description: Github Copilot Get Copilot Content Exclusion Rules for an Organization
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: github-copilot.getcopilotcontentexclusionrules
      outputParameters:
      - type: object
        mapping: $.
    - name: setcopilotcontentexclusionrules
      description: Github Copilot Set Copilot Content Exclusion Rules for an Organization
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: github-copilot.setcopilotcontentexclusionrules
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    GITHUB_COPILOT_TOKEN: GITHUB_COPILOT_TOKEN