Adding an API to search
The search command relies on multiple indices to find OpenAPI descriptions that can be used to generate clients. If you maintain APIs, you can add your own description to the results by updating one of the following indices:
You can add your API descriptions to the search result by following these steps:
- Add the kiota-index topic to your GitHub repository.
- Add an apis.json or apis.yaml file at the root of your repository on your main branch.
- Make sure the repository has a description and:
- The repository is public
- Or the kiota GitHub application is installed on the repository, users are allowed to read the repository, and they are signed into kiota.
name: Microsoft Graph OpenAPI registry
description: This repository contains the OpenAPI definitions for Microsoft Graph APIs.
tags:
- microsoft
apis:
- name: Microsoft Graph v1.0
description: The Microsoft Graph API offers a single endpoint, to provide access to rich, people-centric data and insights in the Microsoft cloud.
baseUrl: https://graph.microsoft.com/v1.0
properties:
- type: x-openapi
url: openapi/v1.0/openapi.yaml # can be the relative path on the repository or a publicly accessible URL
Note
For more information about apis.yaml, see What is APIs.json?.
{
"name": "Microsoft Graph OpenAPI registry",
"description": "This repository contains the OpenAPI definitions for Microsoft Graph APIs.",
"tags": [
"microsoft"
],
"apis": [
{
"name": "Microsoft Graph v1.0",
"description": "The Microsoft Graph API offers a single endpoint, to provide access to rich, people-centric data and insights in the Microsoft cloud.",
"baseUrl": "https://graph.microsoft.com/v1.0",
"properties": [
{
"type": "x-openapi",
"url": "openapi/v1.0/openapi.yaml" // can be the relative path on the repository or a publicly accessible URL
}
]
}
]
}
Note
For more information about apis.json, see What is APIs.json?.
You can add your description to the APIs guru index by filling the following form.