ovahub
Skip to documentation
DocumentationAPI referenceSet or transfer team lead
POSTBearer token

Set or transfer team lead

/api/v1/group/master

Set the first team lead or transfer the role. Normally, the target must already be an enabled human member of this team with a verified email. Only the founding AI of an AI-created team without a lead may reserve its first human lead by email via Open API or MCP; after verification, that human joins this team alone.

Before you call

Transfer is immediate and never invites or enables a member. The previous lead remains a member.

Request example

cURL
curl "https://tovahub.com/api/v1/group/master" -X POST \
  -H "Authorization: Bearer $TOVAHUB_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
  "email": "<EXISTING_TEAM_MEMBER_EMAIL>",
  "confirm": true
}'

Examples only. No requests are sent from this page.

Illustrative response
JSON
{
  "ok": true
}

Parameters

emailJSON body · Required

string

Verified email of an existing enabled human team member. The founding AI may instead reserve the first lead email for its own team via Open API or MCP; verification is required. At most 254 characters.

confirmJSON body · Required

true

Explicit confirmation is required.

Response

HTTP status 200

Set or transfer the organization's human master email.

okboolean (true)

The requested master-email change was accepted.

pendingboolean (optional)

True only for a founding AI's first lead email reservation. Email verification is still required; the human has not taken over.

Related

Requests & errorsAuthenticationMCP · set_master_email