# Credentials

Source: https://webagent-docs-staging.lookover.ai/api-reference/credentials

> Stored sign-in credentials for the vault (secrets are never returned).

## GET /v1/credentials

List credentials (no secrets)

Parameters:
- `namespace` (query): string

Responses: 200 `CredentialList`, default `ErrorBody`

## POST /v1/credentials

Store a credential

Parameters:
- `Idempotency-Key` (header): string. Retry safely: the same key and body replay the first answer.

Request body (JSON): `CreateCredentialRequest`

Responses: 201 `CredentialInfo`, default `ErrorBody`

## PATCH /v1/credentials/{id}

Change a credential

Parameters:
- `id` (path, required): string

Request body (JSON): `PatchCredentialRequest`

Responses: 200 `CredentialInfo`, default `ErrorBody`

## DELETE /v1/credentials/{id}

Delete a credential

Parameters:
- `id` (path, required): string

Responses: 200 `Deleted`, default `ErrorBody`

## GET /v1/secret-providers

List secret providers

Responses: 200 `SecretProviderList`, default `ErrorBody`

## POST /v1/secret-providers

Connect a secret provider (1Password, Bitwarden; admins)

Parameters:
- `Idempotency-Key` (header): string. Retry safely: the same key and body replay the first answer.

Request body (JSON): `CreateSecretProviderRequest`

Responses: 201 `SecretProviderInfo`, default `ErrorBody`

## DELETE /v1/secret-providers/{id}

Remove a secret provider (admins; 409 while credentials use it)

Parameters:
- `id` (path, required): string

Responses: 200 `Deleted`, default `ErrorBody`

## POST /v1/secret-providers/{id}/test

Test a secret provider (admins)

Parameters:
- `id` (path, required): string

Responses: 200 `SecretProviderInfo`, default `ErrorBody`