---
title: "Update organization"
method: PATCH
path: "/v1/organization"
tags: ["Organization"]
---

# Update organization

`PATCH /v1/organization`

Partially updates the authenticated organization's scheduling defaults. Work hours and daily or weekly load-limit options replace atomically; scalar groups merge per field. Omitted settings are preserved and the response returns the updated organization representation.

## Request body

- OrganizationPatch
  - `settings` OrganizationSettingsPatch, required
    - `work_hours` object[] — Replaces the complete organization work-hours schedule when supplied; omission preserves it.
      - `day` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
      - `start` string, required
      - `end` string, required
    - `interviewer_load_limits` object — Partially updates daily and weekly limits; omitted periods retain their current values.
      - `daily` object
        - `maximum` object, nullable
          - `limit` integer, required
          - `type` 'NUMBER_OF_INTERVIEWS' | 'NUMBER_OF_MINUTES', required
        - `minimum` object
          - `interviews` integer
          - `minutes` integer
      - `weekly` object
        - `maximum` object, nullable
          - `limit` integer, required
          - `type` 'NUMBER_OF_INTERVIEWS' | 'NUMBER_OF_MINUTES', required
        - `minimum` object
          - `interviews` integer
          - `minutes` integer
    - `interview_buffer` object — Partially updates interview-buffer minutes; omitted values retain their current values.
      - `before_minutes` union
        - 0
        - 15
        - 30
      - `after_minutes` union
        - 0
        - 15
        - 30
    - `feedback_writing_time_minutes` union — Replaces the feedback-writing time when supplied; omission preserves it.
      - 0
      - 15
      - 30
    - `conflict_keywords` object — Partially updates conflict-keyword lists; omitted lists retain their current values, while supplied lists replace that category.
      - `out_of_office` string[]
      - `avoid` string[]
      - `available_if_needed` string[]
      - `recruiting_block` string[]

## Response `200`

Success

- Organization
  - `id` string, required — Canonical organization ID (org_ followed by 32 lowercase hexadecimal UUID characters).
  - `name` string, required
  - `domain` string, required
  - `settings` OrganizationSettings, required
    - `work_hours` object[], required
      - `day` 'MONDAY' | 'TUESDAY' | 'WEDNESDAY' | 'THURSDAY' | 'FRIDAY' | 'SATURDAY' | 'SUNDAY', required
      - `start` string, required
      - `end` string, required
    - `interviewer_load_limits` object, required
      - `daily` object, required
        - `maximum` object, nullable, required
          - `limit` integer, required
          - `type` 'NUMBER_OF_INTERVIEWS' | 'NUMBER_OF_MINUTES', required
        - `minimum` object, required
          - `interviews` integer, required
          - `minutes` integer, required
      - `weekly` object, required
        - `maximum` object, nullable, required
          - `limit` integer, required
          - `type` 'NUMBER_OF_INTERVIEWS' | 'NUMBER_OF_MINUTES', required
        - `minimum` object, required
          - `interviews` integer, required
          - `minutes` integer, required
    - `interview_buffer` object, required
      - `before_minutes` union, required
        - 0
        - 15
        - 30
      - `after_minutes` union, required
        - 0
        - 15
        - 30
    - `feedback_writing_time_minutes` union, required — Allowed values: 0, 15, or 30 minutes.
      - 0
      - 15
      - 30
    - `conflict_keywords` object, required
      - `out_of_office` string[], required
      - `avoid` string[], required
      - `available_if_needed` string[], required
      - `recruiting_block` string[], required

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `409` — Conflict
- `410` — Gone
- `500` — Internal error

---

[API](https://skmtc.dev/modernloop/apis/modernloop-platform-api.md) · [All operations](https://skmtc.dev/modernloop/apis/modernloop-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/modernloop/modernloop-platform-api/revisions/33a0f9f44e4c/schema)