Share a mind with a user

Give one user access to this mind. Re-granting changes their role.

Self-service: the owner, or an admin the owner appointed. Only the owner may grant admin — an admin sharing onward as admin would let write access propagate with no step at which the owner is consulted.

A viewer reads the mind and everything it reaches: the brains it holds and the skills it carries. That is the point of sharing a mind, and it is a wider grant than sharing a brain — the skills become instructions in the recipient's context. Share deliberately.

POST

https://truememory-api.mvstg.com/minds/{mind_id}/grants

View as Markdown

Authorization

HTTPBearerHTTPrequired

Path parameters

mind_idstringrequired
format: uuid

Header parameters

X-App-Idoptional
One of the following:
string
null
}
X-On-Behalf-Ofoptional
One of the following:
string
null
}
X-External-User-Idoptional
One of the following:
string
null
}

Request bodyJSONrequired

user_idstringrequired
maxLength: 255 · minLength: 1
roleoptionalvieweroradmin
default: "viewer"

Returns

201

Successful Response

JSON

mind_idstringrequired
user_idstringrequired
rolevieweroradminrequired
granted_atstringrequired
format: date-time
app_idoptional
One of the following:
string
null
}
display_nameoptional
One of the following:
string
null
}
emailoptional
One of the following:
string
null
}

422

Validation Error

JSON

detailoptionalarray ofobject
- locarray ofrequired
  One of the following:
  string
  integer
- msgstringrequired
- typestringrequired
- inputoptionalunknown
- ctxoptionalobject
}

curl --request POST \ --url 'https://truememory-api.mvstg.com/minds/<mind_id>/grants' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "user_id": "string", "role": "viewer" } '