GoodMemGet a space by ID
GET /v1/spaces/{id}: Retrieves a specific space by its unique identifier.
Retrieves a specific space by its unique identifier. Returns the complete space information, including name, labels, embedder configuration, and metadata. Requires READ_SPACE on the requested space. The service distinguishes a missing space from an existing space the caller cannot read. This is a read-only operation safe to retry.
ApiKeyAuthx-api-key<token>id*stringThe unique identifier of the space to retrieve
GoodMem-Timeout-Ms?integerOptional waiting budget in milliseconds, measured from REST servlet ingress and shared across all internal gRPC calls. Supply one decimal integer from 1 to 86400000. Omission adds no deadline. Existing shorter deadlines still apply. Expiry returns HTTP 504 before streaming starts; after streaming starts, no successful completion event is sent. Use SSE or opt into GoodMem-Stream-Terminal for an explicit terminal outcome. Retrieval work is cooperatively cancelled. An accepted mutation may still commit after timeout or disconnect; a failed response does not imply rollback.
int641 <= value <= 86400000Successfully retrieved space
application/json- response
A Space is a container for organizing related memories with vector embeddings.
spaceId*stringThe UUID for this space.
uuid"550e8400-e29b-41d4-a716-446655440000"name*stringThe name of the space.
1 <= length <= 255"Research Project Space"labels*Key-value pairs of metadata associated with the space.
{ "project": "AI Research", "team": "NLP Group"}spaceEmbedders*array<>The list of embedders associated with this space.
createdAt*integerTimestamp when this space was created (milliseconds since epoch).
int641651483320000updatedAt*integerTimestamp when this space was last updated (milliseconds since epoch).
int641651483320000ownerId*stringThe ID of the user who owns this space.
uuid"550e8400-e29b-41d4-a716-446655440000"createdById*stringThe ID of the user who created this space.
uuid"550e8400-e29b-41d4-a716-446655440000"updatedById*stringThe ID of the user who last updated this space.
uuid"550e8400-e29b-41d4-a716-446655440000"defaultChunkingConfig?||Default chunking strategy for memories in this space
{ "recursive": { "chunkSize": 1000, "chunkOverlap": 200, "separators": [ "\n\n", "\n", ".", " " ], "keepStrategy": "KEEP_END", "separatorIsRegex": false, "lengthMeasurement": "CHARACTER_COUNT" }, "sentence": { "maxChunkSize": 1000, "minChunkSize": 100, "enableLanguageDetection": true, "lengthMeasurement": "CHARACTER_COUNT" }}curl -X GET 'https://your-goodmem-server.example.com/v1/spaces/550e8400-e29b-41d4-a716-446655440000' \ -H 'GoodMem-Timeout-Ms: 30000'{ "spaceId": "550e8400-e29b-41d4-a716-446655440000", "name": "Research Project Space", "labels": { "project": "AI Research", "team": "NLP Group" }, "spaceEmbedders": [ { "spaceId": "550e8400-e29b-41d4-a716-446655440000", "embedderId": "550e8400-e29b-41d4-a716-446655440000", "defaultRetrievalWeight": 1, "createdAt": 1651483320000, "updatedAt": 1651483320000, "createdById": "550e8400-e29b-41d4-a716-446655440000", "updatedById": "550e8400-e29b-41d4-a716-446655440000" } ], "createdAt": 1651483320000, "updatedAt": 1651483320000, "ownerId": "550e8400-e29b-41d4-a716-446655440000", "createdById": "550e8400-e29b-41d4-a716-446655440000", "updatedById": "550e8400-e29b-41d4-a716-446655440000", "defaultChunkingConfig": { "recursive": { "chunkSize": 1000, "chunkOverlap": 200, "separators": [ "\n\n", "\n", ".", " " ], "keepStrategy": "KEEP_END", "separatorIsRegex": false, "lengthMeasurement": "CHARACTER_COUNT" }, "sentence": { "maxChunkSize": 1000, "minChunkSize": 100, "enableLanguageDetection": true, "lengthMeasurement": "CHARACTER_COUNT" } }}