# List integrations

URL: https://heaven.dev/docs/reference/integrations/view
Updated: 2026-11-21

List the selected account's integrations, their addresses and attachments. Credential values are masked.

`GET /v1/organization/integration/`

## Parameters

- `organization` (string): Organization name or ID. A credential, named resource or sole membership can select the organization for you.

## Returns

- `data` (object[], always present): Integrations and their configurations and attachments.
  - `items` (object): An integration's configuration and attachments.
    - `address` (string): Service address used from an attached Computer. May be omitted.
    - `attachments` (string[] | null, always present): Computers allowed to call it: computer:NAME, pool:POOL, tag:TAG or auto:all.
    - `comment` (string, always present): Saved description of this integration.
    - `computers` (integer): How many of the organization's Computers are attached to it; absent when every one is (auto:all). May be omitted.
    - `connected_by_you` (boolean): Whether you connected this GitHub integration. Your account permissions govern connection management. May be omitted.
    - `github_user` (string): GitHub identity used by a GitHub integration. May be omitted.
    - `id` (string, always present): Integration ID.
    - `last_call_at` (string (date-time) | null, always present): Last recorded call from an attached Computer, to the minute; null if none is recorded.
    - `last_call_status` (integer): HTTP status of the last recorded call: the service's own, or Heaven's when it refused the call or could not reach the service. May be omitted.
    - `name` (string, always present): Integration name.
    - `owners` (string[]): GitHub accounts and organizations with an app installation at the last check. May be omitted.
    - `paused` (boolean): Whether integration pause stopped its calls; the credential and attachments stay until integration resume. May be omitted.
    - `peer_computer_id` (string): Destination Computer's ID for a peer integration. May be omitted.
    - `read_only` (boolean): Whether the GitHub integration is restricted to read access. May be omitted.
    - `reconnect` (boolean): Whether GitHub rejected the connection or the connecting member left. May be omitted.
    - `repositories` (integer): Number of repositories accessible at the last count. May be omitted.
    - `strip_prefix` (string, always present): Request-path prefix removed before forwarding.
    - `target` (string, always present): Configured destination service.
    - `type` (string, always present): Service type this integration connects.

## Errors

Each code is explained in full at https://heaven.dev/docs/reference/errors.

| Code | Status | What happened |
|---|---:|---|
| `invalid` | 400 | An input is missing or invalid. |
| `unauthenticated` | 401 | The credential is missing, invalid, expired or revoked. |
| `denied` | 403 | The caller lacks permission for this action. |
| `not_found` | 404 | The resource is absent or inaccessible to this caller. |
| `conflict` | 409 | The request conflicts with the current resource state or an earlier request. |
| `over_capacity` | 409 | The request exceeds a resource or credential allowance. |
| `access_list_full` | 409 | The change would exceed the access-list allowance. |
| `rate_limited` | 429 | The caller's request rate exceeds its limit. |
| `busy` | 429 | Too much work is in progress to accept this request. |
| `unknown` | 503 | The outcome is unconfirmed; a change may have happened. |
| `unavailable` | 503 | The service or requested feature is unavailable. |

## Notes

- API key permission: `integration view`.

## Examples

```sh tab="heaven CLI"
heaven integration view
  [--organization ORGANIZATION]
```

```sh tab="SSH"
ssh cli@heaven.dev integration view
  [--organization ORGANIZATION]
```

```sh tab="cURL"
curl https://heaven.dev/v1/organization/integration/ \
  -H "Authorization: Bearer $HEAVEN_API_KEY"
```

```json tab="MCP"
{ "tool": "integration_view",
  "arguments": {  } }
```

Response:

```json title="Response excerpt"
{
  "version": 1,
  "data": [
    {
      "address": "self.int.heaven.dev",
      "attachments": [
        "auto:all"
      ],
      "comment": "",
      "id": "0ad21e29-d74b-4b43-aa1e-82e349156b64",
      "last_call_at": null,
      "name": "self",
      "strip_prefix": "",
      "target": "",
      "type": "self"
    }
  ]
}
```
