---
title: "Update your organization"
method: PUT
path: "/org/me"
tags: ["Organization"]
---

# Update your organization

`PUT /org/me`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/me`
- Auth: API key in header `X-API-Key`

Updates editable organization fields. Only fields present in the body are changed; `websites` and `locations`, when provided, replace the existing lists.

## Request body

- UpdateOrgRequest: Editable organization fields. All fields optional — only those present are changed.
  - `name` string
  - `slug` string
  - `logo_url` string: The org's logo URL. Send an empty string to clear it.
  - `websites` OrgWebsiteInput[]: Replaces the org's website list.
    - `url` string, uri, required: The website URL.
  - `locations` OrgLocationInput[]: Replaces the org's location list.
    - `country_code` string, required: Two-letter country code (e.g. `US`). Only the length is validated on this endpoint.
    - `region_name` string: Optional sub-national region.

## Response `200`

The updated organization.

- OrgDetailResponse: Full details of your organization.
  - `org_id` string, uuid, required
  - `name` string, required
  - `slug` string, required
  - `clerk_org_id` string: The organization's id in the external identity provider, when the organization is linked to one.
  - `logo_url` string
  - `primary_website_url` string
  - `network_id` string, uuid: The network the organization belongs to. Networks are not required, so this is absent for a standalone organization.
  - `network_name` string, required
  - `industry_id` string, uuid
  - `industry_name` string, required
  - `partner_id` string, uuid, required
  - `is_free_tier` boolean, required
  - `enable_runs` boolean, required: Master switch for the org's scheduled runs — when false, the org is paused and no runs are dispatched. Content generation has its own switch, `enable_content_generation`.
  - `is_activated` boolean, required
  - `websites` OrgWebsite[]
    - `org_website_id` string, uuid, required
    - `url` string, required
  - `locations` OrgLocation[]
    - `org_location_id` string, uuid, required
    - `country_code` string, required: ISO 3166-1 alpha-2 country code.
    - `region_name` string: Sub-national region, when set.
  - `models` OrgModel[]
    - `geo_model_id` string, uuid, required
    - `name` string, required: The model identifier.
  - `schedule` integer[]: Weekdays the org's question runs are scheduled on, 0 = Sunday … 6 = Saturday.
  - `spend_limit` number: Optional monthly spend cap, when set.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `deleted_at` string, date-time: When the organization was deleted; absent while it is active.
  - `enable_content_generation` boolean, required
  - `content_auto_publish` boolean, required
  - `content_schedule` integer[]: Weekdays content-generation runs are scheduled on, 0 = Sunday … 6 = Saturday.
  - `publishers` Publisher[]
    - `publisher_id` string, uuid, required
    - `scope` string: Ownership scope of the destination (e.g. org-specific or platform-shared).
    - `name` string, required
    - `slug` string, required
    - `type` string, required: The destination kind.
    - `display_url` string, required: A human-facing URL for the destination.
    - `logo_url` string: Destination logo URL, when set.
    - `active` boolean, required
  - `initial_user` OrgInitialUser: The initial user provisioned with the org. Present only on org-creation responses, never on reads.
    - `user_id` string, uuid, required
    - `org_user_id` string, uuid, required
    - `email` string, required
    - `role` string, required: The role the initial user was granted (always `admin`).

## Other responses

- `400`: The request body was invalid — either it failed field validation (`ValidationErrorResponse`) or was otherwise malformed (`ErrorResponse`).
- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.
- `404`: The requested resource does not exist or is not visible to this key.
- `409`: The request conflicts with the current state (e.g. a duplicate).

---

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