System > API Keys

Edit an API Key

Update an existing API Key to keep its information up to date.

Two Line OfieREQUIRED: The API Module must be enabled for your organization to perform the functions on this support page. Reach out to your Customer Success Manager to enable it.

Who can edit an API Key?

Only people with the "API Administrator" permission can edit API Keys.

Edit an API Key

To edit an API Key, navigate to the API Keys administration page, then:

  • Hover over the API Key you want to edit so that it is highlighted blue, then click the pencil icon that appears to its right and the Edit API Key window will open.

The API Keys admin page with an arrow pointing to an API Keys edit button

  • Update the following information as necessary:
    • Name (required): The name will be used to identify this API Key.
    • Determine the API Key's level of access within KaiNexus — the people and Items with which it has permission to work — by configuring its Locations and Roles:
      • Network Locations (required): Use this field to search for and select the appropriate Network Location(s).
      • Roles: The API Key's Roles determine its powers and permissions within KaiNexus. For example, an API Key with the "View Private" permission for a specific Location can be used to export an Item List containing private Items in that Location.
        • To add a Role, click the plus icon in the top-right corner of the Roles section and, in the resulting drop-down menu, check the checkbox next to each Role you want to add.
        • To remove a Role, click the x button to the right of that Role.
      • If the API Key has two or more Network Locations and one or more Roles, you can determine which Roles should apply in which Locations. To do so, click the cogwheel icon in the top-right corner of the Roles section to open the Advanced Role Configuration window.
        • If the intersection of a Role and a Location has a checkmark, that Role's permissions will be applied in that Location; if the intersection is unchecked, that Role will not apply in that Location.

          Check and uncheck Role/Location intersections as necessary, then click Save.
    • Click Save.