---
title: "Update referring agent"
method: PUT
path: "/api/files/sales/{saleGuid}/referringagent"
tags: ["Sale Referring Agents"]
---

# Update referring agent

`PUT /api/files/sales/{saleGuid}/referringagent`

Updates the sale's referring agent details. firstName and lastName are required. email is required on update and must be valid. Phone, fax, and alternatePhone must be 10 numerical digits when provided.

### Validation & Requirements
#### Required Parameters
- `saleGuid` (path, string, format=guid)
- `form` (body, object)

#### Required JSON Body Fields
- None

#### Validations
- Invalid GUID values in `*Guid`/`*Guids` fields return `422 Unprocessable Entity`.
- Invalid date values in `*date*` fields return `422 Unprocessable Entity`.
- Missing required request body returns `422 Unprocessable Entity` with `Missing request body.`.
- Additional business-rule validation may return `422` with details in the `errors` array.
- If provided, email must be valid.
- Phone, fax, and alternate phone must be exactly 10 numeric digits.

#### Integration Requirement
- Retrieve the corresponding `...Form` endpoint immediately before write operations to get current dynamic required fields and allowed values.

## Path parameters

- `saleGuid` string, guid, required

## Request body

- UpdateSaleReferringAgentForm
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `phoneNumber` string, nullable
  - `email` string, nullable
  - `alternatePhone` string, nullable
  - `fax` string, nullable
  - `company` string, nullable
  - `streetNumber` string, nullable
  - `streetAddress` string, nullable
  - `city` string, nullable
  - `state` string, nullable
  - `zip` string, nullable
  - `publicID` string, nullable

## Response `200`

- LinkedResponseOfAddReferringAgentToSaleResponse
  - `value` AddReferringAgentToSaleResponse
    - `saleGuid` string, guid
    - `contactGuid` string, guid
  - `warnings` string[], nullable
  - `links` Link[], nullable
    - `href` string, nullable
    - `rel` string, nullable
    - `method` string, nullable

## Other responses

- `404`
- `422`

---

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