The following table provides the list of environment variables that can be used to configure the experience for the Kiota CLI.

Kiota offers the following commands to help you build your API client:

• search: search for APIs and their description from various registries.
• download: download an API description.
• show: show the API paths tree for an API description.
• generate: generate a client for any API from its description.
• update: update existing clients from previous generations.
• info: show languages and runtime dependencies information.
• login: signs in to private API descriptions repositories.
• logout: signs out from private API description repositories.

Kiota search accepts the following parameters while searching for APIs and their descriptions.

kiota search <searchTerm>
      [(--clear-cache | --cc)]
      [(--log-level | --ll) <level>]
      [(--version | -v) <version>]

The term to use during the search for APIs and their descriptions.

If multiple results are found, Kiota presents a table with the different results.

The following example returns multiple results.

kiota search github

This command returns the following display.

Key                                  Title               Description            Versions
apisguru::github.com                 GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:api.github.com  GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-2.18       GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-2.19       GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-2.20       GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-2.21       GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-2.22       GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-3.0        GitHub v3 REST API  GitHub's v3 REST API.  1.1.4
apisguru::github.com:ghes-3.1        GitHub v3 REST API  GitHub's v3 REST API.  1.1.4

If the search term is an exact match with one of the results' key, the search command displays a detailed view of the result.

kiota search apisguru::github.com

Key: apisguru::github.com
Title: GitHub v3 REST API
Description: GitHub's v3 REST API.
Service: https://support.github.com/contact
OpenAPI: https://raw.githubusercontent.com/github/rest-api-description/main/descriptions/api.github.com/api.github.com.json

The search command accepts optional parameters commonly available on the other commands:

• --clear-cache
• --log-level
• --version

Kiota download downloads API descriptions to a local from a registry and accepts the following parameters.

It isn't mandatory to download the description locally for generation as the generation command can download the description directly. However, having a local copy of the description can be helpful to inspect it, determine which API paths are needed, and come up with the filters for generation.

kiota download <searchTerm>
      [--clear-cache | --cc]
      [--clean-output | --co]
      [(--log-level | --ll) <level>]
      [(--version | -v) <version>]
      [(--output | -o) <path>]
      [--disable-ssl-validation | --dsv]

The search term to use to locate the description. The description is downloaded only if an exact key match occurs. You can use the search command to find the key of the API description before downloading it.

kiota download apisguru::github.com

The download command accepts optional parameters commonly available on the other commands:

• --clean-output
• --clear-cache
• --log-level
• --output
• --version
• --disable-ssl-validation

Kiota show accepts the following parameters when displaying the API paths tree for a description.

kiota show [(--openapi | -d) <path>]
      [(--log-level | --ll) <level>]
      [--clear-cache | --cc]
      [(--version | -v) <version>]
      [(--search-key | -k) <searchKey>]
      [(--max-depth | --m-d) <maximumDepth>]
      [(--include-path | -i) <glob pattern>]
      [(--exclude-path | -e) <glob pattern>]
      [--disable-ssl-validation | --dsv]

The following command with the provided options displays the following result.

kiota show -d https://raw.githubusercontent.com/microsoftgraph/msgraph-sdk-powershell/dev/openApiDocs/v1.0/Mail.yml -i **/messages

/
 └─users
    └─{user-id}
       ├─mailFolders
       │  └─{mailFolder-id}
       │     ├─childFolders
       │     └─messages
       └─messages

The show command accepts optional parameters commonly available on the other commands:

• --openapi
• --clear-cache
• --log-level
• --include-path
• --exclude-path
• --version
• --search-key
• --disable-ssl-validation

Kiota generate accepts the following parameters during the generation.

kiota generate (--openapi | -d) <path>
      (--language | -l) <language>
      [(--output | -o) <path>]
      [(--class-name | -c) <name>]
      [(--namespace-name | -n) <name>]
      [(--log-level | --ll) <level>]
      [--backing-store | -b]
      [--exclude-backward-compatible | --ebc]
      [--additional-data | --ad]
      [(--serializer | -s) <classes>]
      [(--deserializer | --ds) <classes>]
      [--clean-output | --co]
      [--clear-cache | --cc]
      [(--structured-mime-types | -m) <mime-types>]
      [(--include-path | -i) <glob pattern>]
      [(--exclude-path | -e) <glob pattern>]
      [(--disable-validation-rules | --dvr) <rule name>]
      [--disable-ssl-validation | --dsv]
      [(--type-access-modifier | --tam) <access modifier>]

• openapi
• language

The generate command accepts optional parameters commonly available on the other commands:

• --clear-cache
• --clean-output
• --include-path
• --exclude-path
• --log-level
• --output
• --disable-ssl-validation

Enables backing store for models. Defaults to false.

kiota generate --backing-store

Whether to exclude the code generated only for backward compatibility reasons or not. Defaults to false.

To maintain compatibility with applications that depends on generated clients, Kiota emits extra code marked as obsolete. New clients don't need this extra backward compatible code. The code marked as obsolete will be removed in the next major version of Kiota. Use this option to omit emitting the backward compatible code when generating a new client, or when the application using the existing client being refreshed doesn't depend on backward compatible code.

kiota generate --exclude-backward-compatible

Include the 'AdditionalData' property for generated models. Defaults to true.

kiota generate --additional-data false

The class name to use for the core client class. Defaults to ApiClient.

The provided name MUST be a valid class name for the target language.

kiota generate --class-name MyApiClient

The fully qualified class names for deserializers.

These values are used in the client class to initialize the deserialization providers.

Since version 1.11 this parameter also supports a none key to generate a client with no deserialization providers in order to enable better portability.

Defaults to the following values.

One or more module names that implement IParseNodeFactory.

kiota generate --deserializer Contoso.Json.CustomDeserializer

The name of the OpenAPI description validation rule to disable. Or all to disable all validation rules including the rules defined in OpenAPI.net.

Kiota runs a set of validation rules before generating the client to ensure the description contains accurate information to build great client experience.

Rules:

• DivergentResponseSchema: returns a warning if an operation defines multiple different successful response schemas. (200, 201, 202, 203)
• GetWithBody: returns a warning if a GET request has a body defined.
• InconsistentTypeFormat: returns a warning if an inconsistent type/format pair is defined. (for example, type: string, format: int32)
• KnownAndNotSupportedFormats: returns a warning if a known format isn't supported for generation. (for example, email, uri, ...)
• MissingDiscriminator: returns a warning if an anyOf or oneOf schema is used without a discriminator property name.
• MultipleServerEntries: returns a warning if multiple servers are defined.
• NoContentWithBody: returns a warning if a response schema is defined for a 204 response.
• NoServerEntry: returns a warning if no servers are defined.
• UrlFormEncodedComplex: returns a warning if a URI form encoded response has a schema that contains complex properties.

kiota generate --disable-validation-rules NoServerEntry

The namespace to use for the core client class specified with the --class-name option. Defaults to ApiSdk.

The provided name MUST be a valid module or namespace name for the target language.

kiota generate --namespace-name MyAppNamespace.Clients

A valid URI to an OpenAPI description in the local filesystem or hosted on an HTTPS server.

kiota generate --openapi https://contoso.com/api/openapi.yml

The fully qualified class names for serializers.

These values are used in the client class to initialize the serialization providers.

Since version 1.11 this parameter also supports a none key to generate a client with no serialization providers in order to enable better portability.

Defaults to the following values.

One or more module names that implement ISerializationWriterFactory.

kiota generate --serializer Contoso.Json.CustomSerializer

The MIME types to use for structured data model generation with their preference weight. Any type without a preference has its preference defaulted to 1. Accepts multiple values. The notation style and the preference weight logic follow the convention defined in RFC9110.

Default values:

• application/json;q=1
• application/x-www-form-urlencoded;q=0.2
• multipart/form-data;q=0.1
• text/plain;q=0.9

Any valid MIME type that matches a request body type or a response type in the OpenAPI description.

kiota generate --structured-mime-types application/json

Controls the accessibility level for generated client types.

This can be useful to reduce the scope of visibility in library scenarios where you do not want to expose the generated types to consuming projects.

Default value:

• Public

Available for commands: generate.

• Public
• Internal
• Protected

kiota generate --type-access-modifier Internal

Kiota info accepts the following parameters when displaying language information like their maturity level or dependencies needed at runtime.

kiota info [(--openapi | -d) <path>]
      [(--language | -l) <language>]
      [(--log-level | --ll) <level>]
      [--clear-cache | --cc]
      [(--version | -v) <version>]
      [(--search-key | -k) <searchKey>]
      [(--dependency-type | --dt) <typeKey>]
      [(--json)]

The following command with the provided options displays the following result.

kiota info

Language    Maturity Level
CSharp      Stable
Go          Stable
Java        Preview
PHP         Stable
Python      Stable
Ruby        Experimental
Swift       Experimental
TypeScript  Experimental

The following command with the provided options displays the following result.

kiota info -l CSharp

The language CSharp is currently in Stable maturity level.
After generating code for this language, you need to install the following packages:
dotnet add package Microsoft.Kiota.Abstractions --version 1.6.1
dotnet add package Microsoft.Kiota.Http.HttpClientLibrary --version 1.3.0
dotnet add package Microsoft.Kiota.Serialization.Form --version 1.1.0
dotnet add package Microsoft.Kiota.Serialization.Json --version 1.1.1
dotnet add package Microsoft.Kiota.Authentication.Azure --version 1.1.0
dotnet add package Microsoft.Kiota.Serialization.Text --version 1.1.0
dotnet add package Microsoft.Kiota.Serialization.Multipart --version 1.1.0

The info command accepts optional parameters commonly available on the other commands:

• --openapi
• --clear-cache
• --log-level
• --language
• --version
• --search-key
• --dependency-type
• --json

Using the --json optional parameter renders the output in a machine parsable format:

kiota info -l CSharp --json

{
  "maturityLevel": "Stable",
  "dependencyInstallCommand": "dotnet add package {0} --version {1}",
  "dependencies": [
    {
      "name": "Microsoft.Kiota.Abstractions",
      "version": "1.6.1",
      "type": "abstractions"
    },
    {
      "name": "Microsoft.Kiota.Http.HttpClientLibrary",
      "version": "1.2.0",
      "type": "http"
    },
    {
      "name": "Microsoft.Kiota.Serialization.Form",
      "version": "1.1.0",
      "type": "serialization"
    },
    {
      "name": "Microsoft.Kiota.Serialization.Json",
      "version": "1.1.1",
      "type": "serialization"
    },
    {
      "name": "Microsoft.Kiota.Authentication.Azure",
      "version": "1.1.0",
      "type": "authentication"
    },
    {
      "name": "Microsoft.Kiota.Serialization.Text",
      "version": "1.1.0",
      "type": "serialization"
    },
    {
      "name": "Microsoft.Kiota.Serialization.Multipart",
      "version": "1.1.0",
      "type": "serialization"
    },
    {
      "name": "Microsoft.Kiota.Bundle",
      "version": "1.1.0",
      "type": "bundle"
    }
  ],
  "clientClassName": "",
  "clientNamespaceName": ""
}

Since: 1.18.1

The type of dependencies to display when used in combination with the language option. Does not impact the json output. Accepts multiple values. Default empty.

kiota info --language CSharp --dependency-type authentication

Accepted values:

When no value is provided the info command will display:

• All dependencies when no bundle is available.
• Bundle, authentication and additional dependencies when a bundle is available.

Kiota update accepts the following parameters during the update of existing clients. This command searches for lock files in the output directory and all its subdirectories and triggers generations to refresh the existing clients using settings from the lock files.

kiota update [(--output | -o) <path>]
      [(--log-level | --ll) <level>]
      [--clean-output | --co]
      [--clear-cache | --cc]

The generate command accepts optional parameters commonly available on the other commands:

• --clear-cache
• --clean-output
• --log-level
• --output

Use kiota login to sign in to private repositories and search for/display/generate clients for private API descriptions. This command makes subcommands available to sign in to specific authentication providers.

kiota login github <device|pat>
      [(--log-level | --ll) <level>]
      [(--pat) <patValue>]

Use kiota login github device to sign in using a device code, you're prompted to sign-in using a web browser.

Use kiota login github pat --pat patValue to sign in using a Personal Access Token you previously generated. You can use either a classic personal access token (PAT) or a granular PAT. A classic PAT needs the repo permission and to be granted access to the target organizations. A granular PAT needs a read-only permission for the contents scope under the repository category and they need to be consented for all private repositories or selected private repositories.

The generate command accepts optional parameters commonly available on the other commands:

• --log-level

Use kiota logout to sign out from a private repository containing API descriptions.

kiota logout github
      [(--log-level | --ll) <level>]

The generate command accepts optional parameters commonly available on the other commands:

• --log-level

The following parameters are available across multiple commands.

Delete the output directory before generating the client. Defaults to false.

Available for commands: download, generate.

kiota <command name> --clean-output

Clears the currently cached file for the command. Defaults to false.

Cached files are stored under %TEMP%/kiota/cache and valid for one (1) hour after the initial download. Kiota caches API descriptions during generation and static index files during search.

kiota <command name> --clear-cache

A glob pattern to exclude paths from generation. Accepts multiple values.

kiota <command name> --exclude-path **/users/** --exclude-path **/groups/**

You can also filter specific HTTP methods by appending #METHOD to the pattern, replacing METHOD with the HTTP method to filter. For example, **/users/**#GET.

A glob pattern to include paths from generation. Accepts multiple values. If this parameter is absent, everything is included.

kiota <command name> --include-path **/users/** --include-path **/groups/**

You can also filter specific HTTP methods by appending #METHOD to the pattern, replacing METHOD with the HTTP method to filter. For example, **/users/**#GET.

The location of the OpenAPI description in JSON or YAML format to use to generate the SDK. Accepts a URL or a local path.

Available for commands: info, show, generate.

kiota <command name> --openapi https://description.url/description.yml

The target language for the generated code files or for the information.

Available for commands: info, generate.

• csharp
• go
• java
• php
• python
• ruby
• shell
• swift
• typescript

kiota <command name> --language java

The log level to use when logging events to the main output. Defaults to warning.

Available for commands: all.

• critical
• debug
• error
• information
• none
• trace
• warning

kiota <command name> --log-level information

The output directory or file path for the generated code files. Defaults to ./output for generate and ./output/result.json for download.

Available for commands: download, generate.

A valid path to a directory (generate) or a file (download).

kiota <command name> --output ./src/client

The search key to use to fetch the Open API description. This parameter can be used in combination with the version option. Shouldn't be used in combination with the --openapi option. Default empty.

Available for commands: info and show.

kiota <command name> --search-key apisguru::github.com:api.github.com

Select a specific version of the API description. No default value.

Available for commands: download, search.

kiota <command name> --version beta

The disable SSL validation is an option that allows users to disable SSL certificate validation. When this option is set to true, the SSL certificates presented by HTTPS servers of the OpenAPI description file aren't validated. Disabling validation can be useful in development or testing environments with self-signed certificates.

Available for commands: generate, show, and download.

kiota <command name> --disable-ssl-validation