---
title: "GET /workspaces/integrations"
method: GET
path: "/workspaces/integrations"
tags: ["integrations"]
---

# GET /workspaces/integrations

`GET /workspaces/integrations`

fetch workspace preferences

## Response `200`

OK

- ServerListIntegrationResponse
  - `integrations` MalakWorkspaceIntegration[], required
    - `created_at` string
    - `id` string
    - `integration` MalakIntegration
      - `created_at` string
      - `description` string
      - `id` string
      - `integration_name` string
      - `integration_type` 'oauth2' | 'api_key' | 'default'
      - `is_enabled` boolean
      - `logo_url` string
      - `metadata` MalakIntegrationMetadata
        - `endpoint` string
      - `reference` string
      - `updated_at` string
    - `integration_id` string
    - `is_active` boolean — IsActive determines if the connection to the integration has been tested and works
    - `is_enabled` boolean — IsEnabled - this integration is enabled and data can be fetched
    - `metadata` MalakWorkspaceIntegrationMetadata
      - `access_token` string
      - `last_fetched_at` string
    - `reference` string
    - `updated_at` string
    - `workspace_id` string
  - `message` string, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

## Changes

- **2025-03-20** `d4c143ed44cd` — 1 warning
  - added the new `default` enum value to the `integrations/items/integration/integration_type` response property for the response status `200`
- **2025-02-09** `77ae053437e5` — 1 info
  - added the optional property `integrations/items/metadata/last_fetched_at` to the response with the `200` status
- **2025-02-06** `6bff8fb0772f` — 3 info
  - api tag `integrations` added
  - api tag `workspace` removed
  - added the optional property `integrations/items/metadata` to the response with the `200` status
- **2025-02-04** `03526f9a6486` — 1 info
  - added the optional property `integrations/items/is_active` to the response with the `200` status
- **2025-01-31** `03e6aeeaf5d9` — 1 info
  - added the optional property `integrations/items/integration/metadata/endpoint` to the response with the `200` status

[Full history](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation/changes/workspaces/integrations/get.md)

---

[API](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation.md) · [All operations](https://skmtc.dev/ayinke-llc/apis/malak-s-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ayinke-llc/malak-s-api-documentation/revisions/d4c143ed44cd/schema)