---
title: "Update the current organization"
method: PATCH
path: "/v1/organizations/current"
tags: ["Organizations"]
---

# Update the current organization

`PATCH /v1/organizations/current`

## Request

- Base URL: `https://api.samva.dev`
- URL: `https://api.samva.dev/v1/organizations/current`
- Auth: API key in header `x-api-key`

Updates the current organization's profile, regional defaults, and reply-to default and returns the saved organization. `metadata` is merged into the stored value; every other field is replaced.

## Request body

- object
  - `name` string, nullable
  - `slug` string, nullable
  - `defaultRegion` string: An ISO 3166-1 alpha-2 region code, such as US or IN.
  - `timezone` string
  - `isActive` boolean, nullable
  - `metadata` object, nullable
  - `replyToDefault` string[], nullable
  - `emailFooterEnabledDefault` boolean, nullable

## Response `200`

Organization

- Organization
  - `id` string, required
  - `billingAccountId` string, required
  - `name` string, required
  - `slug` string, required
  - `defaultRegion` string, required: An ISO 3166-1 alpha-2 region code, such as US or IN.
  - `timezone` string, required
  - `plan` string, required
  - `isActive` boolean, required
  - `createdAt` string, required
  - `updatedAt` string, required
  - `metadata` object, nullable, required
  - `replyToDefault` string[], nullable, required
  - `emailFooterEnabledDefault` boolean, nullable, required
  - `messagesUsed` number, required
  - `messagesUsedThisMonth` number, required
  - `emailUsed` number, required
  - `emailUsedThisMonth` number, required
  - `contactsUsed` number, required
  - `conversationsUsed` number, required
  - `teamMembersUsed` number, required
  - `messagesResetAt` string, nullable, required

## Other responses

- `401`: UnauthorizedError
- `403`: ForbiddenError
- `404`: ResourceNotFoundError
- `422`: ValidationError
- `500`: InternalError
- `504`: GatewayTimeoutError

---

[API](https://skmtc.dev/samva/apis/samva-api.md) · [All operations](https://skmtc.dev/samva/apis/samva-api/llms.txt) · [OpenAPI document](https://skmtc.dev/samva/apis/samva-api/revisions/a99408542cc3?raw)