> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /alter/credential

```
URL: http://<db.host>:<db.port>/alter/credential
```

Alter the properties of an existing
[credential](https://docs.kinetica.com/content/concepts/credentials.md).

## Input Parameter Description

**credential\_name** `string`

Name of the credential to be altered. Must be an existing credential.

**credential\_updates\_map** `map of string to strings`

Map containing the properties of the credential to be updated. Error if empty.

**credential\_updates\_map**

**type**

New type for the credential.

The supported values are:

* aws\_access\_key
* aws\_iam\_role
* azure\_ad
* azure\_oauth
* azure\_sas
* azure\_storage\_key
* docker
* gcs\_service\_account\_id
* gcs\_service\_account\_keys
* hdfs
* kafka

**identity**

New user for the credential.

**secret**

New password for the credential.

**schema\_name**

Updates the schema name.  If *schema\_name* doesn't exist, an error will be thrown. If *schema\_name* is empty, then the user's default schema will be used.

**options** `map of string to strings`

Optional parameters.

## Output Parameter Description

The Kinetica server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query.  Here is a description of the various fields of the wrapper:

**status** `String`

'OK' or 'ERROR'

**message** `String`

Empty if success or an error message

**data\_type** `String`

'alter\_credential\_response' or 'none' in case of an error

**data** `String`

Empty string

**data\_str** `JSON or String`

This embedded JSON represents the result of the /alter/credential endpoint:

**data\_str**

**credential\_name** `string`

Value of input parameter *credential\_name*.

**info** `map of string to strings`

Additional information.

Empty string in case of an error.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.