---
title: "Add Location Collaborators"
method: PATCH
path: "/public/v3/Locations/{locationId}/addCollaborators"
tags: ["Locations"]
---

# Add Location Collaborators

`PATCH /public/v3/Locations/{locationId}/addCollaborators`

Add/Update an existing Tive user or invite an external user to collaborate on a shipment that uses the specified location.

## Path parameters

- `locationId` integer, required

## Headers

- `x-tive-account-id` integer, required

## Request body

- UpsertLocationCollaboratorsRequest
  - `collaborators` LocationCollaboratorRequest[], required — A list of users you would like to collaborate with and their access level for any shipment using the specified location.
    - `email` string, required — Email address of the user collaborator.
    - `roleName` string, required — Name of the shipment role you would like to assign to a user. Values can be Viewer, Contributor, or Editor.

## Response `200`

Collaborators updated

## Other responses

- `400` — Collaborators not updated
- `401` — Unauthorized

---

[API](https://skmtc.net/tive/apis/tive-public-api.md) · [All operations](https://skmtc.net/tive/apis/tive-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tive/tive-public-api/revisions/9a8d869e3cdc/schema)