Skip to Content
webagent docs
API reference

Credentials

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

Open as .md
GET
/v1/credentials

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Query Parameters

namespace?string
Lengthlength <= 64

Response Body

OK

application/json
  1. response
credentials*array<>
Example Request
curl -X GET 'https://api.us.webagent.lookover.ai/v1/credentials'
Example Response
{  "credentials": [    {      "id": "string",      "origin": "string",      "namespace": "string",      "label": "string",      "username": "string",      "hasTotp": true,      "source": {        "providerId": "string",        "reference": "string",        "provider": "1password"      },      "lastResolvedAt": 0,      "resolveError": "string",      "createdAt": 0,      "updatedAt": 0    }  ]}

Store a credential

POST
/v1/credentials

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Header Parameters

Idempotency-Key?string

Retry safely: the same key and body replay the first answer.

Length1 <= length <= 255

Request Body

application/json
  1. body
origin*string
Lengthlength <= 300
username?string
Lengthlength <= 500
password?string
Length1 <= length <= 5000
source?
namespace?string
Length1 <= length <= 64
label?string
Lengthlength <= 200
totpSecret?string
Lengthlength <= 200

Response Body

OK

application/json
  1. response
id*string
origin*string
namespace*string
label*string
username*string
hasTotp*boolean
source?
lastResolvedAt?number
resolveError?string
createdAt*number
updatedAt*number
Example Request
curl -X POST 'https://api.us.webagent.lookover.ai/v1/credentials' \  -H 'Content-Type: application/json' \  -d '{  "origin": "string"}'
Example Response
{  "id": "string",  "origin": "string",  "namespace": "string",  "label": "string",  "username": "string",  "hasTotp": true,  "source": {    "providerId": "string",    "reference": "string",    "provider": "1password"  },  "lastResolvedAt": 0,  "resolveError": "string",  "createdAt": 0,  "updatedAt": 0}

Change a credential

PATCH
/v1/credentials/{id}

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

id*string
Match^cred_(us|in)_[0-9a-z]{24}$

Request Body

application/json
  1. body
username?string
Length1 <= length <= 500
password?string
Length1 <= length <= 5000
source?
label?string
Lengthlength <= 200
totpSecret?|null

Response Body

OK

application/json
  1. response
id*string
origin*string
namespace*string
label*string
username*string
hasTotp*boolean
source?
lastResolvedAt?number
resolveError?string
createdAt*number
updatedAt*number
Example Request
curl -X PATCH 'https://api.us.webagent.lookover.ai/v1/credentials/string' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "string",  "origin": "string",  "namespace": "string",  "label": "string",  "username": "string",  "hasTotp": true,  "source": {    "providerId": "string",    "reference": "string",    "provider": "1password"  },  "lastResolvedAt": 0,  "resolveError": "string",  "createdAt": 0,  "updatedAt": 0}

Delete a credential

DELETE
/v1/credentials/{id}

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

id*string
Match^cred_(us|in)_[0-9a-z]{24}$

Response Body

OK

application/json
  1. response
deleted*boolean
Example Request
curl -X DELETE 'https://api.us.webagent.lookover.ai/v1/credentials/string'
Example Response
{  "deleted": true}

List secret providers

GET
/v1/secret-providers

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Response Body

OK

application/json
  1. response
providers*array<>
Example Request
curl -X GET 'https://api.us.webagent.lookover.ai/v1/secret-providers'
Example Response
{  "providers": [    {      "id": "string",      "provider": "1password",      "label": "string",      "scope": "string",      "settings": {        "property1": "string",        "property2": "string"      },      "status": "ok",      "lastCheckedAt": 0,      "error": "string",      "createdAt": 0,      "updatedAt": 0    }  ]}
POST
/v1/secret-providers

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Header Parameters

Idempotency-Key?string

Retry safely: the same key and body replay the first answer.

Length1 <= length <= 255

Request Body

application/json
  1. body
provider*string
Value in"1password""bitwarden"
token*string
Length1 <= length <= 5000
label?string
Lengthlength <= 200
scope?string
Lengthlength <= 500
settings?

Response Body

OK

application/json
  1. response
id*string
provider*string
Value in"1password""bitwarden"
label*string
scope*string
settings*
status*string
Value in"ok""error""untested"
lastCheckedAt?number
error?string
createdAt*number
updatedAt*number
Example Request
curl -X POST 'https://api.us.webagent.lookover.ai/v1/secret-providers' \  -H 'Content-Type: application/json' \  -d '{  "provider": "1password",  "token": "string"}'
Example Response
{  "id": "string",  "provider": "1password",  "label": "string",  "scope": "string",  "settings": {    "property1": "string",    "property2": "string"  },  "status": "ok",  "lastCheckedAt": 0,  "error": "string",  "createdAt": 0,  "updatedAt": 0}
DELETE
/v1/secret-providers/{id}

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

id*string
Match^sp_(us|in)_[0-9a-z]{24}$

Response Body

OK

application/json
  1. response
deleted*boolean
Example Request
curl -X DELETE 'https://api.us.webagent.lookover.ai/v1/secret-providers/string'
Example Response
{  "deleted": true}
POST
/v1/secret-providers/{id}/test

Authorization

headerAuthorizationBearer <token>

An API key (wa_<region>_…) or a dashboard access token.

Path Parameters

id*string
Match^sp_(us|in)_[0-9a-z]{24}$

Response Body

OK

application/json
  1. response
id*string
provider*string
Value in"1password""bitwarden"
label*string
scope*string
settings*
status*string
Value in"ok""error""untested"
lastCheckedAt?number
error?string
createdAt*number
updatedAt*number
Example Request
curl -X POST 'https://api.us.webagent.lookover.ai/v1/secret-providers/string/test'
Example Response
{  "id": "string",  "provider": "1password",  "label": "string",  "scope": "string",  "settings": {    "property1": "string",    "property2": "string"  },  "status": "ok",  "lastCheckedAt": 0,  "error": "string",  "createdAt": 0,  "updatedAt": 0}