> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update object storage WIF config

> Create or update the organization's object storage WIF configuration.



## OpenAPI

````yaml /openapi/sandboxes/openapi.yaml patch /v1/settings/objectStorageWifConfig
openapi: 3.0.3
info:
  title: CoreWeave Sandboxes API
  version: 0.0.1
  description: >-
    The Sandboxes API lets you manage runners, templates, volumes, network
    configurations, organization settings, and the lifecycle of individual
    sandboxes on CoreWeave.
servers:
  - url: https://api.cwsandbox.com
    description: >-
      CoreWeave sandbox data plane. Hosts the sandbox lifecycle, volumes,
      snapshots, runner discovery, and organization settings.
  - url: https://api.coreweave.com
    description: >-
      CoreWeave control plane. Hosts managed runner and sandbox template
      administration.
security:
  - bearerAuth: []
tags:
  - name: NetworkConfigService
    description: >-
      Create, get, list, update, and delete desired network configurations.
      Updating a configuration bound to a running sandbox changes its network
      rules without a restart. Requires API enablement and a runner with live
      network update support.
  - name: SandboxService
    description: >-
      Endpoints for the sandbox lifecycle: create (directly, from a template, or
      from a Compose file), get, list, exec, read and write files, snapshot,
      connect, purge, and delete.
  - name: DiscoveryService
    description: >-
      Read-only endpoints for discovering the runners visible to the caller's
      organization, with view, capability, and service-visibility filters.
      Runner IDs are unique only within an organization.
  - name: SettingsService
    description: >-
      Organization-level sandbox settings: the object-storage Workload Identity
      Federation (WIF) configuration, the file-system snapshot bucket
      configuration, Compose build storage, and secret stores.
  - name: VolumeService
    description: >-
      CRUD operations for organization-registered volumes that sandboxes can
      mount, plus the validation call that confirms a volume's backing source is
      usable.
  - name: RunnerManagementService
    description: >-
      CRUD operations for managed runners and the runner policy each one
      carries. Policy is a field on the runner, mutated through
      `CreateManagedRunner` and `UpdateManagedRunner`.
  - name: SandboxTemplateService
    description: >-
      CRUD operations for organization-scoped sandbox templates, the partial
      specs that `CreateSandboxFromTemplate` merges with per-request overrides.
paths:
  /v1/settings/objectStorageWifConfig:
    patch:
      tags:
        - SettingsService
      summary: Update object storage WIF config
      description: UpdateObjectStorageWifConfig creates or updates the org's WIF config.
      operationId: SettingsService_UpdateObjectStorageWifConfig
      parameters:
        - name: updateMask
          in: query
          description: >-
            Comma-separated JSON paths to update. An omitted or empty mask
            replaces the whole configuration. The wildcard * is supported only
            over binary protobuf (gRPC or Connect protobuf), not JSON Connect or
            the REST updateMask query value.
          schema:
            type: string
            format: field-mask
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/coreweave.sandbox.v1.ObjectStorageWifConfig'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/coreweave.sandbox.v1.ObjectStorageWifConfig
        default:
          description: Default error response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/google.rpc.Status'
      servers:
        - url: https://api.cwsandbox.com
          description: CoreWeave sandbox data plane.
components:
  schemas:
    coreweave.sandbox.v1.ObjectStorageWifConfig:
      description: >-
        ObjectStorageWifConfig is the organization's object-storage
        workload-identity
         federation config and the policy ceiling for per-sandbox object_storage_access.
      type: object
      properties:
        wifConfigId:
          description: >-
            The WIF config id from the CoreWeave Cloud Console (a Workload
            Federation
             configuration). Required on create / full-replace.
          type: string
        enabled:
          description: Whether object-storage access is enabled for the organization.
          type: boolean
        allowedBuckets:
          description: Buckets the org may access; empty means all buckets.
          type: array
          items:
            type: string
        maxPermission:
          description: >-
            Maximum permission a sandbox may be granted. Specify
            OBJECT_STORAGE_PERMISSION_READ or
            OBJECT_STORAGE_PERMISSION_READ_WRITE on create, full replacement, or
            an update that selects maxPermission.
            OBJECT_STORAGE_PERMISSION_UNSPECIFIED is invalid in these writes. A
            partial update that excludes this field preserves its current value.
          type: string
          format: enum
          enum:
            - OBJECT_STORAGE_PERMISSION_UNSPECIFIED
            - OBJECT_STORAGE_PERMISSION_READ
            - OBJECT_STORAGE_PERMISSION_READ_WRITE
        createTime:
          type: string
          format: date-time
          readOnly: true
        updateTime:
          type: string
          format: date-time
          readOnly: true
    google.rpc.Status:
      description: >-
        The `Status` type defines a logical error model that is suitable for
        different programming environments, including REST APIs and RPC APIs. It
        is used by [gRPC](https://github.com/grpc). Each `Status` message
        contains three pieces of data: error code, error message, and error
        details. You can find out more about this error model and how to work
        with it in the [API Design
        Guide](https://cloud.google.com/apis/design/errors).
      type: object
      properties:
        code:
          description: >-
            The status code, which should be an enum value of
            [google.rpc.Code][google.rpc.Code].
          type: integer
          format: int32
        message:
          description: >-
            A developer-facing error message, which should be in English. Any
            user-facing error message should be localized and sent in the
            [google.rpc.Status.details][google.rpc.Status.details] field, or
            localized by the client.
          type: string
        details:
          description: >-
            A list of messages that carry the error details.  There is a common
            set of message types for APIs to use.
          type: array
          items:
            $ref: '#/components/schemas/google.protobuf.Any'
    google.protobuf.Any:
      description: >-
        Contains an arbitrary serialized message along with a @type that
        describes the type of the serialized message.
      type: object
      properties:
        '@type':
          description: The type of the serialized message.
          type: string
      additionalProperties: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: CoreWeave API access token sent as a bearer token.
      x-default: Bearer {API_ACCESS_TOKEN}

````