---
title: "Update prospect field values"
method: POST
path: "/v1/prospects/{prospectId}/attribute"
tags: ["prospects"]
---

# Update prospect field values

`POST /v1/prospects/{prospectId}/attribute`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/prospects/{prospectId}/attribute`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/prospects/:prospectId/attribute/post.ts> (a function with typed inputs; its response is checked against the schema)

Sets or updates the value of one or more fields on a prospect profile. To update a single field, provide <code>fieldId</code> and <code>attributeValue</code>. To update multiple fields in one request, provide an <code>attributes</code> array where each item contains a <code>fieldId</code> and the new value. Use the field IDs returned by the GET /fields endpoint.

## Path parameters

- `prospectId` string, required

## Request body

- UpsertProspectAttributeDto
  - `fieldId` string: The ID of the field to update. Use this for updating a single field. Use the field IDs returned by the GET /fields endpoint. Required when "attributes" is not provided.
  - `attributeValue` string: The new value to set for the field specified by "fieldId". Required when "fieldId" is provided.
  - `attributes` ProspectAttributeItem[]: A list of field updates to apply in a single request. Use this to update multiple fields at once. Each item must specify a fieldId and the new value. When this is provided, "fieldId" and "attributeValue" are ignored.
    - `fieldId` string, required: The ID of the field to update. Use the field IDs returned by the GET /fields endpoint.
    - `attributeValue` string, required: The new value to set for this field.

## Response `201`

Prospect attribute updated successfully

- unknown

## Other responses

- `400`: 50001: Failed to prospect attribute<br><br>
- `500`: 5001: Internal server error, please try again later<br><br>

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)