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

# Update placeholder

> Update a placeholder's name, value or who fills it in (fillingType) via the Sendforsign API.

### Body parameters

**data** `object` *required*

**child attribute**

**action** `string` *required*

Action type.

**clientKey** `string` *required*

Key of the client.

**contractKey** `string` *required*

Key of the contract.

**placeholder** `object` *required*

Structure, add the fields that need to be updated and ignore the rest.

**child attribute**

**placeholderKey** `string` *required*

Key of the placeholder that needs to be updated.

**name** `string`

Name of the placeholder

**value** `string`

Value of the placeholder.

**fillingType** `number`

Who fills in this placeholder when the contract is shared ("Who fills in this field" in the editor):
`1` — nobody (default), `2` — the contract owner, `3` — any recipient, `4` — a specific recipient set in `externalRecipientKey`.
[See the use case.](https://sendforsign.com/docs/usecase/placeholder-filler.md)

**externalRecipientKey** `string`

`recipientKey` of the recipient who fills in this placeholder. Required when `fillingType` is `4`.
Get it from the [list of recipients](https://sendforsign.com/docs/api-reference/recipient/list.md). To unassign the recipient, send `"externalRecipientKey": null` explicitly together with the new `fillingType` (for example `1`, `2` or `3`): a field left out of an update keeps its current value, so omitting it does **not** clear it.

### Response

**placeholder** `string`

Placeholder structure.

**child attribute**

**changeTime** `string`

Change time.

**code** `string`

The code of the answer.

**message** `string`

The message of the answer.

```bash cURL theme={null}
curl -X POST 'https://api.sendforsign.com/api/placeholder' \
     -H 'X-Sendforsign-Key: YOUR_API_KEY' \
     -H 'Content-Type: application/json' \
     -d '{
    "data": {
        "action": "update",
        "clientKey": "YOUR_CLIENT_KEY",
        "contractKey": "CONTRACT_KEY",
        "placeholder": {
            "placeholderKey": "PLACEHOLDER_KEY",
            "name": "Name",
            "value": "Value",
            "fillingType": 4,
            "externalRecipientKey": "RECIPIENT_KEY"
        }
    }
}'
```

```json Response theme={null}
{
    "placeholder": {
        "id": "1",
        "createTime": "2024-03-14T20:34:08.000Z",
        "changeTime": "2024-03-14T20:38:39.000Z",
        "name": "Name",
        "value": "Value",
        "type": "1",
        "placeholderKey": "PLACEHOLDER_KEY",
        "position": null
    },
    "code": "201",
    "message": "Placeholder updated"
}
```


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