Kolide

Kolide Registration Requests API

The Registration Requests API from Kolide — 2 operation(s) for registration requests.

GitHub OpenAPI

Operations 4

GET /registration_requests Fetch a list of Registration requests #
GET /registration_requests/{id} Fetch information for a specific Registration request #
PATCH /registration_requests/{id} Update an existing Registration request #
PUT /registration_requests/{id} Update an existing Registration request #

Documentation

📖
Documentation
https://www.kolide.com/docs/developers/api
📖
APIReference
https://kolideapi.readme.io/reference
📖
Authentication
https://artifacts.apis.io/kolide/authentication/kolide-authentication.yml

Specifications

⚙
OpenAPI
https://artifacts.apis.io/kolide/openapi/kolide-registration-requests-api-openapi.yml

Other Resources

🔗
Conventions
https://artifacts.apis.io/kolide/conventions/kolide-conventions.yml
🔗
ErrorCatalog
https://artifacts.apis.io/kolide/errors/kolide-problem-types.yml
🔗
DataModel
https://artifacts.apis.io/kolide/data-model/kolide-data-model.yml
🔗
Webhooks
https://artifacts.apis.io/kolide/asyncapi/kolide-events.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/kolide:kolide-registration-requests-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kolide-registration-requests-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: '2026-04-07'
  title: K2 Registration Requests API
servers:
- url: https://api.kolide.com/
security:
- api_key: []
tags:
- name: Registration Requests
paths:
  /registration_requests:
    get:
      summary: Fetch a list of Registration requests
      parameters:
      - name: x-kolide-api-version
        in: header
        description: Specify the API version to be used
        required: false
        schema:
          type: string
          default: '2026-04-07'
      - name: cursor
        in: query
        description: Specify the cursor to begin returning results from
        required: false
        schema:
          type: string
          default: ''
      - name: per_page
        in: query
        description: Specify the number of records to return in each response.
        required: false
        schema:
          type: integer
          format: int32
          maximum: 100
          minimum: 1
          default: 25
      - name: query
        in: query
        description: "A query clause used to filter the set of resources returned. Use\n`:` for exact matches (including for boolean fields), `~` for\npartial-string matches. `:[\"a\",\"b\",\"c\"]` or `:[1,2,3]`\ncan be used for fields that support multi-value search.\n Datetime fields support exact-matching\n(`:`) as well as less-than (`<`) and greater-than (`>`). The\nsearchable fields are:\n\n`status` , `requested_at` , `requester_message`\n\nSearch clauses can be combined with the ` AND ` and ` OR ` operators.\n\nFor more information, see the [search documentation](https://www.kolide.com/docs/developers/api#search).\n"
        required: false
        examples:
          'status:':
            summary: search the 'status' property of the Registration Request records using ':' operator
            value: status:enumerated-value
          'requested_at:':
            summary: search the 'requested_at' property of the Registration Request records using ':' operator
            value: requested_at:2000-01-08T20:38:21Z
          requested_at<:
            summary: search the 'requested_at' property of the Registration Request records using '<' operator
            value: requested_at<2000-01-08T20:38:21Z
          requested_at>:
            summary: search the 'requested_at' property of the Registration Request records using '>' operator
            value: requested_at>2000-01-08T20:38:21Z
          'requester_message:':
            summary: search the 'requester_message' property of the Registration Request records using ':' operator
            value: requester_message:string
          requester_message~:
            summary: search the 'requester_message' property of the Registration Request records using '~' operator
            value: requester_message~string
        schema:
          type: string
      responses:
        '200':
          description: A paginated collection of Registration requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    description: 'A registration request is created when someone requests admin

                      approval to register a device with Kolide. Registration requests can

                      be approved or denied by admins.

                      '
                    type: array
                    items:
                      $ref: '#/components/schemas/registration_request'
                  pagination:
                    type: object
                    description: Information about the current and next pages of results
                    properties:
                      next:
                        type: string
                        format: uri
                        description: The full URL that should be used to fetch the next page of results. This will be blank if there are no more results to fetch
                        example: https://api.kolide.com/registration_requests?per_page=10&cursor=Imyw
                      current_cursor:
                        type: string
                        description: the pagination cursor used to fetch this page of results
                        example: Miwy
                      next_cursor:
                        type: string
                        description: 'the pagination cursor that can be used to fetch the page of results following the current page. This will be blank if there are no more results to fetch '
                        example: NCw0
                      count:
                        type: integer
                        description: the number of records in the current page of results
                        example: 10
        '401':
          description: An 'unauthorized' response may occur for features restricted by or unavailable to your organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: an error message describing why the endpoint is unavailable
                    example: This feature has been disabled by your organization
        '403':
          description: A 'forbidden' response may occur if the API key does not have necessary permissions to perform certain actions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: a succinct error message
                    example: Forbidden
                  message:
                    type: string
                    description: A longer-form error message explaining the reason for the response
                    example: The API key used is not authorized to perform this action
      tags:
      - Registration Requests
      operationId: getRegistrationRequests
      x-operation-id-source: derived
  /registration_requests/{id}:
    get:
      summary: Fetch information for a specific Registration request
      parameters:
      - name: x-kolide-api-version
        in: header
        description: Specify the API version to be used
        required: false
        schema:
          type: string
          default: '2026-04-07'
      - name: id
        in: path
        required: true
        description: The ID of the registration request
        schema:
          type: string
      responses:
        '200':
          description: 'A registration request is created when someone requests admin

            approval to register a device with Kolide. Registration requests can

            be approved or denied by admins.

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/registration_request'
        '401':
          description: An 'unauthorized' response may occur for features restricted by or unavailable to your organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: an error message describing why the endpoint is unavailable
                    example: This feature has been disabled by your organization
        '403':
          description: A 'forbidden' response may occur if the API key does not have necessary permissions to perform certain actions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: a succinct error message
                    example: Forbidden
                  message:
                    type: string
                    description: A longer-form error message explaining the reason for the response
                    example: The API key used is not authorized to perform this action
      tags:
      - Registration Requests
      operationId: getRegistrationRequestsById
      x-operation-id-source: derived
    patch:
      summary: Update an existing Registration request
      parameters:
      - name: x-kolide-api-version
        in: header
        description: Specify the API version to be used
        required: false
        schema:
          type: string
          default: '2026-04-07'
      - name: id
        in: path
        required: true
        description: The ID of the registration request
        schema:
          type: string
      responses:
        '200':
          description: The updated Registration request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/registration_request'
        '401':
          description: An 'unauthorized' response may occur for features restricted by or unavailable to your organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: an error message describing why the endpoint is unavailable
                    example: This feature has been disabled by your organization
        '403':
          description: A 'forbidden' response may occur if the API key does not have necessary permissions to perform certain actions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: a succinct error message
                    example: Forbidden
                  message:
                    type: string
                    description: A longer-form error message explaining the reason for the response
                    example: The API key used is not authorized to perform this action
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/registration_request_request_body'
      tags:
      - Registration Requests
      operationId: patchRegistrationRequestsById
      x-operation-id-source: derived
    put:
      summary: Update an existing Registration request
      parameters:
      - name: x-kolide-api-version
        in: header
        description: Specify the API version to be used
        required: false
        schema:
          type: string
          default: '2026-04-07'
      - name: id
        in: path
        required: true
        description: The ID of the registration request
        schema:
          type: string
      responses:
        '200':
          description: The updated Registration request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/registration_request'
        '401':
          description: An 'unauthorized' response may occur for features restricted by or unavailable to your organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: an error message describing why the endpoint is unavailable
                    example: This feature has been disabled by your organization
        '403':
          description: A 'forbidden' response may occur if the API key does not have necessary permissions to perform certain actions
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: a succinct error message
                    example: Forbidden
                  message:
                    type: string
                    description: A longer-form error message explaining the reason for the response
                    example: The API key used is not authorized to perform this action
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/registration_request_request_body'
      tags:
      - Registration Requests
      operationId: putRegistrationRequestsById
      x-operation-id-source: derived
components:
  schemas:
    link-object:
      type: object
      properties:
        identifier:
          type: string
          description: the canonical identifier for this object
        link:
          type: string
          format: url
          description: the API URL where complete information about this object can be found
    registration_request:
      type: object
      properties:
        id:
          type: string
          description: The canonical identifier for this Registration Request
        status:
          type: string
          description: 'The current status of this registration request. One of: pending, approved, denied'
        requester_message:
          type: string
          description: The message the person provided when requesting approval for this registration
        internal_denial_note:
          type: string
          description: The internal explanation the admin provided when denying this request, for internal documentation. This message is not shown to the person requesting the registration approval. This property will be blank if the registration has not been denied.
        internal_approval_note:
          type: string
          description: The internal explanation the admin provided when approving this request, for internal documentation. This message is not shown to the person requesting the registration approval. This property will be blank if the registration has not been approved.
        requested_at:
          type: string
          description: The timestamp representing when the registration approval was requested
          format: date-time
        end_user_denial_note:
          type: string
          description: The message the admin provided for the requester when denying this registration request. This message is meant to be shown to the person requesting the exemption. This property will be blank if the exemption has not been denied
        requester_information:
          allOf:
          - description: Information for fetching the complete data on the person who requested this registration
          - $ref: '#/components/schemas/link-object'
        device_information:
          allOf:
          - description: Information for fetching the complete data about the device the person is trying to register
          - $ref: '#/components/schemas/link-object'
    registration_request_request_body:
      type: object
      properties:
        status:
          type: string
          description: 'Desired status of the registration request. One of: ''approved'' or ''denied'''
        internal_denial_reason:
          type: string
          description: 'DEPRECATED: use the ''internal_message'' field instead.

            The internal explanation for denying this request.

            This message is not shown to the person requesting

            registration approval, it is only for internal documentation

            in the audit log. This parameter is ignored unless the status is ''denied''.

            '
        internal_message:
          type: string
          description: 'The internal explanation for approving or denying this request.

            This message is not shown to the person requesting

            registration approval, it is only for internal documentation

            in the audit log. This parameter is optional

            '
        end_user_denial_message:
          type: string
          description: 'The message the admin provided for the requester when denying

            this registration. This message is meant to be shown to the

            person requesting registration approval. This parameter is

            required if the status is ''denied''

            '
  securitySchemes:
    api_key:
      type: http
      scheme: bearer