Transfer ownership of a space
POST /v1/spaces/{id}:transferOwnership: Transfers an existing space to another active human or service principal.
Transfers an existing space to another active human or service principal. The current space owner, the GoodMem instance owner, or an instance administrator may transfer it; a space-scoped administrator cannot. Only owner and update-audit fields change. Memories, embedder associations, grants, and role assignments remain unchanged. This operation is not idempotent under response semantics: after an unknown outcome, read the space before retrying.
ApiKeyAuthx-api-key<token>id*stringUUID of the existing space to transfer
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 <= 86400000Destination owner principal
application/json- body
Names the principal that will become the resource owner.
newOwnerId*stringExisting principal UUID that will become the new owner.
uuid"550e8400-e29b-41d4-a716-446655440000"Space ownership transferred
application/json- response
The space after its ownership transfer completes.
space*Updated space with its new owner and audit metadata.
curl -X POST 'https://your-goodmem-server.example.com/v1/spaces/550e8400-e29b-41d4-a716-446655440000:transferOwnership' \ -H 'GoodMem-Timeout-Ms: 30000' \ -H 'Content-Type: application/json' \ -d '{ "newOwnerId": "550e8400-e29b-41d4-a716-446655440000"}'{ "space": { "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" } } }}