# Retrieve space

Retrieve a space by its ID, including its dedicated vector store and any additional attached vector stores.

Retrieve the details of a space. Requires view access to the space.

#### Path Parameters

**`space_id`** string required

The unique identifier of the space (e.g., `space_abc123...`).

## Returns

A Space object containing the space configuration, its dedicated `vector_store_id`, and `additional_vector_store_ids` for any externally attached vector stores.

**Key fields:**

- `vector_store_id` — The space's auto-created dedicated vector store (used for embedding thread messages as shared memory).
- `additional_vector_store_ids` — Array of external vector store IDs attached to this space for expanded knowledge access.


Request

```bash cURL
curl "https://api.aitronos.com/v1/spaces/space_abc123" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]

response = requests.get(
    "https://api.aitronos.com/v1/spaces/space_abc123",
    headers={"X-API-Key": api_key},
)
print(response.json())
```


```javascript JavaScript
const response = await fetch(
  "https://api.aitronos.com/v1/spaces/space_abc123",
  {
    headers: { "X-API-Key": apiKey },
  }
);
const data = await response.json();
```

Response

```json 200 OK
{
  "id": "space_abc123",
  "organization_id": "org_abc123",
  "created_by": "usr_abc123",
  "name": "Product Knowledge Base",
  "description": "Shared memory for product team conversations",
  "vector_store_id": "vs_auto123",
  "access_mode": "organization",
  "access_users": null,
  "access_departments": null,
  "editable_by_users": null,
  "editable_by_roles": null,
  "visible_to_roles": null,
  "additional_vector_store_ids": ["vs_catalog456", "vs_docs789"],
  "last_activity_at": "2026-02-26T15:30:00Z",
  "created_at": "2026-02-26T10:00:00Z",
  "updated_at": "2026-02-26T15:30:00Z"
}
```


```json 404 Not Found
{
  "success": false,
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "message": "The requested resource could not be found.",
    "system_message": "Space not found",
    "type": "client_error",
    "status": 404,
    "details": { "space_id": "space_invalid" },
    "trace_id": "abc-123-def",
    "timestamp": "2026-02-26T10:00:00Z"
  }
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You don't have permission to perform this action.",
    "system_message": "View access required",
    "type": "client_error",
    "status": 403,
    "details": { "space_id": "space_abc123" },
    "trace_id": "abc-123-def",
    "timestamp": "2026-02-26T10:00:00Z"
  }
}
```

## Related Resources

- [Create Space](/docs/api-reference/spaces/create)
- [List Spaces](/docs/api-reference/spaces/list)
- [Update Space](/docs/api-reference/spaces/update)
- [Delete Space](/docs/api-reference/spaces/delete)
- [Add Vector Store to Space](/docs/api-reference/spaces/add-vector-store)
- [List Space Vector Stores](/docs/api-reference/spaces/list-vector-stores)