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

Header Parameters

GoodMem-Timeout-Ms?integer

Optional 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.

Formatint64
Range1 <= value <= 86400000

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 "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"
      }
    }
  }
}
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty
Empty