GoodMemGoodMem
ReferenceAPIREST APISpaces

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.

POST
/v1/spaces/{id}:transferOwnership
x-api-key<token>

In: header

Path Parameters

idstring

UUID of the existing space to transfer

Destination owner principal

newOwnerIdstring

Existing principal UUID that will become the new owner.

Example"550e8400-e29b-41d4-a716-446655440000"
Formatuuid

Response Body

curl -X POST "https://your-goodmem-server.example.com/v1/spaces/550e8400-e29b-41d4-a716-446655440000:transferOwnership" \  -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"
      }
    }
  }
}
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty