GoodMemGoodMem
ReferenceAPIREST APISpaces

Transfer ownership of a space

POST /v1/spaces/{id}:transferOwnership: Transfers an existing space to another active human or service principal.

POST
/v1/spaces/{id}:transferOwnership

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.

Authorization

ApiKeyAuth
headerx-api-key<token>

Path Parameters

id*string

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

Request Body

Destination owner principal

application/json
  1. body

Names the principal that will become the resource owner.

newOwnerId*string

Existing principal UUID that will become the new owner.

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

Response Body

Space ownership transferred

application/json
  1. response

The space after its ownership transfer completes.

space*

Updated space with its new owner and audit metadata.

Example Request
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"}'
Example Response
{  "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"      }    }  }}