ovhcloud_iam_user_token_create.md

February 27, 2026 · View on GitHub

ovhcloud iam user token create

Create a new token

Synopsis

Use this command to create a new token. There are three ways to define the creation parameters:

Using only CLI flags:

ovhcloud iam user token create --name Token --description Desc
Using a configuration file:

First you can generate an example of parameters file using the following command:

ovhcloud iam user token create --init-file ./params.json

You will be able to choose from several examples of parameters. Once an example has been selected, the content is written in the given file. After editing the file to set the correct creation parameters, run:

ovhcloud iam user token create --from-file ./params.json

Note that you can also pipe the content of the parameters file, like the following:

cat ./params.json | ovhcloud iam user token create

In both cases, you can override the parameters in the given file using command line flags, for example:

ovhcloud iam user token create --from-file ./params.json --name Token --description Desc

3. Using your default text editor:

ovhcloud iam user token create --editor

You will be able to choose from several examples of parameters. Once an example has been selected, the CLI will open your default text editor to update the parameters. When saving the file, the creation will start.

Note that it is also possible to override values in the presented examples using command line flags like the following:

ovhcloud iam user token create --editor --name Token --description Desc

ovhcloud iam user token create <user_login> [flags]

Options

      --description string   Description of the token
      --editor               Use a text editor to define parameters
      --expiredAt string     Expiration date of the token (RFC3339 format)
      --expiresIn int        Number of seconds before the token expires
      --from-file string     File containing parameters
  -h, --help                 help for create
      --init-file string     Create a file with example parameters
      --name string          Name of the token
      --replace              Replace parameters file if it already exists

Options inherited from parent commands

  -d, --debug            Activate debug mode (will log all HTTP requests details)
  -e, --ignore-errors    Ignore errors in API calls when it is not fatal to the execution
  -o, --output string    Output format: json, yaml, interactive, or a custom format expression (using https://github.com/PaesslerAG/gval syntax)
                         Examples:
                           --output json
                           --output yaml
                           --output interactive
                           --output 'id' (to extract a single field)
                           --output 'nested.field.subfield' (to extract a nested field)
                           --output '[id, "name"]' (to extract multiple fields as an array)
                           --output '{"newKey": oldKey, "otherKey": nested.field}' (to extract and rename fields in an object)
                           --output 'name+","+type' (to extract and concatenate fields in a string)
                           --output '(nbFieldA + nbFieldB) * 10' (to compute values from numeric fields)
      --profile string   Use a specific profile from the configuration file