---
title: "List sockets for a space"
method: GET
path: "/api/v1/spaces/{space_id}/sockets"
tags: ["sockets"]
---

# List sockets for a space

`GET /api/v1/spaces/{space_id}/sockets`

Get all integration sockets for the specified space

## Path parameters

- `space_id` string, required

## Response `200`

Successful Response

- SocketList — List of sockets response.
  - `sockets` SpaceSocket[], required
    - `socket_name` string, required — Socket name
    - `description` string, nullable — Socket description
    - `socket_config` SocketConfiguration, required — Socket configuration including triggers, conditions, and actions.
      - `triggers` SocketTrigger[] — Socket triggers
        - `event` string, required — Trigger event type
        - `conditions` object[], nullable — Trigger conditions
      - `actions` SocketAction[] — Socket actions
        - `type` string, required — Action type
        - `parameters` object, required — Action parameters
        - `condition` object, nullable — Action condition
      - `error_handling` object, nullable — Error handling configuration
      - `execution_mode` string — Execution mode: sync or async
      - `priority` integer — Socket execution priority
    - `socket_id` string, required — Unique socket identifier
    - `space_id` string, required — Space this socket belongs to
    - `user_id` string, required — User who owns this socket
    - `is_active` boolean — Whether socket is active
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, nullable — Last update timestamp
    - `integration_bindings` IntegrationBinding[] — Socket integrations
      - `integration_type` string, required — Type of integration
      - `integration_name` string, required — Name of the integration
      - `permissions` SpacePermissions, required — Permission model for socket integration bindings.
        - `can_read` boolean — Permission to read memories
        - `can_write` boolean — Permission to create memories
        - `can_search` boolean — Permission to search memories
        - `can_delete` boolean — Permission to delete memories
        - `filters` object, nullable — Content filtering rules
        - `rate_limits` object, nullable — Rate limiting configuration
      - `auth_config` object, required — Authentication configuration
      - `binding_id` string, required — Unique binding identifier
      - `socket_id` string, required — Socket this binding belongs to
      - `is_active` boolean — Whether binding is active
      - `status` string — Binding status: pending (waiting for first memory), active (has received memory), inactive (manually deactivated)
      - `created_at` string, date-time, required — Creation timestamp
      - `last_used` string, date-time, nullable — Last used timestamp
      - `access_token_preview` string, nullable — Preview of access token
  - `total_count` integer, required
  - `space_id` string, required

## Other responses

- `403` — Access denied
- `404` — Socket not found
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.net/memara/apis/memara-api.md) · [All operations](https://skmtc.net/memara/apis/memara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/memara/memara-api/versions/4dc7c4418845/schema)