---
title: "Get socket details"
method: GET
path: "/api/v1/sockets/{socket_id}"
tags: ["sockets"]
---

# Get socket details

`GET /api/v1/sockets/{socket_id}`

Get detailed information about a specific socket

## Path parameters

- `socket_id` string, required

## Response `200`

Successful Response

- SpaceSocket — Full space socket model.
  - `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

## 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)