---
title: "Update the prefs for company"
method: PATCH
path: "/companies/{identifier}"
tags: ["companies"]
---

# Update the prefs for company

`PATCH /companies/{identifier}`

This endpoint will allow you to update the prefs for a company based on its identifier.
Requires the privilege [`COMPANY_PREFERENCES_WRITE`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required

## Request body

- CompanyPatch
  - `prefs` CompanyPrefsPatch
    - `monitoring` MonitoringPrefsPatch
      - `optIn` boolean
    - `production` boolean
    - `targetAllAdhoc` boolean
    - `pniScope` 'Company' | 'Team'
    - `jitProvisioning` boolean
    - `llmAccess` boolean
    - `haltAllMoratorium` boolean
    - `haltAllMoratoriumDuration` object — The duration of the halt all moratorium. Expects a number followed by a suffix of d, h or m. Example: 3d/3h/3m
      - `seconds` integer
      - `zero` boolean
      - `nano` integer
      - `negative` boolean
      - `positive` boolean
      - `units` object[]
        - `durationEstimated` boolean
        - `duration` object
          - `seconds` integer
          - `zero` boolean
          - `nano` integer
          - `negative` boolean
          - `positive` boolean
        - `timeBased` boolean
        - `dateBased` boolean
    - `testCooldownDuration` object — Delay between tests in a test series run. Expects a number followed by a suffix of d, h or m. Example: 5m/1h. Min: 2m, Max: 12h
      - `seconds` integer
      - `zero` boolean
      - `nano` integer
      - `negative` boolean
      - `positive` boolean
      - `units` object[]
        - `durationEstimated` boolean
        - `duration` object
          - `seconds` integer
          - `zero` boolean
          - `nano` integer
          - `negative` boolean
          - `positive` boolean
        - `timeBased` boolean
        - `dateBased` boolean
    - `extraCredit` boolean
  - `defaultCompanyRole` string
  - `defaultTeamRole` string

## Response `default`

default response

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege: COMPANY_PREFERENCES_WRITE

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)