Switch households

POST

/api/auth/organization/set-active

curl --request POST \
  --url http://localhost:3000/api/auth/organization/set-active \
  --header 'Content-Type: application/json' \
  --cookie merran.session_token=<merran.session_token> \
  --data '{ "organizationId": "0199e8b0-5a10-7a01-8b00-000000000003" }'

• Your Merran

Makes another of your households the one in use on this device. Better Auth calls households organizations, so it’s named by organizationId. An API key always works in its own household.

Authorizations

• session

Request Body^required

Media typeapplication/json

object

organizationId

The organization id to set as active. It can be null to unset the active organization. Eg: “org-id”

string | null

organizationSlug

The organization slug to set as active. It can be null to unset the active organization if organizationId is not provided. Eg: “org-slug”

string

Example

{
  "organizationId": "0199e8b0-5a10-7a01-8b00-000000000003"
}

Responses

200

Success

Media typeapplication/json

The organization

object

id

required

string

name

required

string

slug

required

string

logo

string

createdAt

required

string format: date-time

metadata

string

Example

{
  "id": "0199e8b0-5a10-7a01-8b00-000000000003",
  "name": "The Riveras",
  "slug": "the-riveras",
  "logo": null,
  "createdAt": "2026-10-01T17:30:00.000Z",
  "metadata": null
}

400

Bad Request. Usually due to missing parameters, or invalid parameters.

Media typeapplication/json

object

message

required

string

Example ^generated

{
  "message": "example"
}

401

Unauthorized. Due to missing or invalid authentication.

Media typeapplication/json

object

message

required

string

Example ^generated

{
  "message": "example"
}

403

Forbidden. You do not have permission to access this resource or to perform this action.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}

404

Not Found. The requested resource was not found.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}

429

Too Many Requests. You have exceeded the rate limit. Try again later.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}

500

Internal Server Error. This is a problem with the server that you cannot fix.

Media typeapplication/json

object

message

string

Example ^generated

{
  "message": "example"
}