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

# Change a location's visibility

> Changes the visibility of a location the token can manage.



## OpenAPI

````yaml /openapi.json patch /v1/locations/{id}/visibility
openapi: 3.1.0
info:
  title: OVRSEA API
  version: 1.3.2
servers:
  - url: https://api.cf.ovrsea.com
security: []
paths:
  /v1/locations/{id}/visibility:
    patch:
      tags:
        - Locations
      summary: Change a location's visibility
      description: Changes the visibility of a location the token can manage.
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                visibility:
                  description: >-
                    Private is visible to the owning account and its authorized
                    hierarchy. Public is shared with the owning account's
                    connected network.
                  enum:
                    - private
                    - public
                  type: string
              required:
                - visibility
              type: object
      responses:
        '200':
          description: The location with its new visibility.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Location'
        '403':
          description: The token can read the location but cannot change it.
          content:
            application/json:
              schema:
                description: The token can read the location but cannot change it.
                type: string
        '404':
          description: The location is absent or not readable by the token.
          content:
            application/json:
              schema:
                description: The location is absent or not readable by the token.
                type: string
components:
  schemas:
    Location:
      type: object
      modelName: Location
      properties:
        id:
          type: string
          example: 12345
        owner:
          type: object
          description: The account that owns and manages this location.
          properties:
            id:
              type: string
              example: '12345'
            name:
              type: string
              example: Acme France
          required:
            - id
            - name
        company_name:
          type: string
          example: Logistics WorldWide Co
        name:
          type: string
          example: Saint Quentin warehouse
        client_reference:
          type: string
          description: Your own identifier for the location.
          example: WH-LYS-01
        address:
          type: string
          example: 357 allée des Tilleuls
        city:
          type: string
          example: Saint Quentin Fallavier
        zip_code:
          type: string
          example: 69300
        state:
          type: string
          description: State or province code.
          example: NY
        country:
          type: string
          example: FR
        contacts:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
                example: Thierry Henriet
              email:
                type: string
                example: log@patagonia.com
              phone:
                type: string
                example: 33134567891
        opening_hours:
          type: string
          example: Monday to Friday 8am to 5pm
        requires_appointment:
          type: boolean
          description: >-
            Specifies if appointments are required for loading and unloading at
            this location.
        requires_tailgate_truck:
          type: boolean
          description: Specifies if liftgate trucks are required for this location.
          example: false
        additional_information:
          type: string
          example: Please avoid Friday after 4pm
        visibility:
          type: string
          enum:
            - private
            - public
          description: >-
            Private locations are visible to the owner and its authorized
            hierarchy. Public locations are shared with the owner's connected
            network.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.