# List

Source: <https://everruns.com/docs/api/operations/list/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Identity & access](https://everruns.com/docs/api/groups/identity-access/)/List

# List

Preview

Manage organizations, members, end users, invitations and connected identities.

Public APIEverruns Cloud and self-hosted Platform

GET`/v1/credential-bindings`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Query Parameters

**scope**

required

string

Session, agent, virtual_user, organization

**owner_id**

string

Owner ID, or me for the current virtual user

**usage**

required

string

User or service

## Responses

200Write-only credential metadata

### 200

Write-only credential metadata

Media typeapplication/json

Array\<object>

Credential metadata for an authorized owner. Secret values are never included.

object

**binding**

HTTP destination and injection metadata, without the credential value.

**configured**

required

Whether a stored value or connection reference is provisioned; does not imply current access.

boolean

**expires_at**

Absolute credential expiry in UTC, if configured.

string | null format: date-time

**id**

required

Stable credential binding identifier.

string format: uuid

**kind**

required

Binding kind identifying HTTP or MCP parameter injection.

string

**label**

required

Human-readable label shown in Credentials settings and consent requests.

string

**last_used_agent_id**

Actual responding agent at the most recent use, if recorded.

string | null format: uuid

**last_used_agent_name**

Display name of the most recently recorded responding agent.

string | null

**last_used_at**

Most recent authorized use, if any.

string | null format: date-time

**mcp_server_url**

Exact MCP endpoint for an MCP parameter binding.

string | null

**name**

HTTP reference name, used as `$NAME`; absent for MCP-only bindings.

string | null

**parameter_name**

Top-level MCP parameter receiving the injected value.

string | null

**revision**

required

Current revision required for value replacement or credential revocation.

integer format: int64

**scope**

required

Ownership scope; runtime authorization is evaluated separately.

string

**source_connection_id**

Native connection supplying credentials without copying its tokens into this binding.

string | null format: uuid

**tool_name**

Exact MCP tool receiving the injected parameter.

string | null

### Example generated

```json
[
  {
    "binding": "example",
    "configured": true,
    "expires_at": "2026-04-15T12:00:00Z",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "kind": "example",
    "label": "example",
    "last_used_agent_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "last_used_agent_name": "example",
    "last_used_at": "2026-04-15T12:00:00Z",
    "mcp_server_url": "example",
    "name": "example",
    "parameter_name": "example",
    "revision": 1,
    "scope": "example",
    "source_connection_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "tool_name": "example"
  }
]
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/credential-bindings?scope=example&usage=example';
const options = {method: 'GET'};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request GET \
  --url 'https://app.everruns.com/api/v1/credential-bindings?scope=example&usage=example'
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Write-only credential metadata

```json
[
  {
    "configured": true,
    "id": "string",
    "kind": "string",
    "label": "string",
    "revision": 0,
    "scope": "string"
  }
]
```

## Matching endpoints