> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/llms.txt)

# Update Public Links

> PUT /profiles/{profile_id}/public_links
> 
> Updates public links, each found by `id`, by `page_id`, or by both. Fields left out keep their value.
> 
> `password`: a non-empty string sets a new password (stored RSA-encrypted). `""` removes the password, so the link no longer asks for one. `null` or leaving `password` out keeps the current password.
> 
> ### Authorization
> 
> The same rule as **Create Public Links**, applied to the form each link belongs to: SERVER users any form; COMPANY users their own profile's non-shared forms; BASIC users with the Form Builder role only forms they created. An internal API client gets no exemption. Every link is checked before anything is written, so one link the caller cannot modify fails the whole request with `403`.



## Servers
- https://api.iformbuilder.com/exzact/api/v80/[servername]: https://api.iformbuilder.com/exzact/api/v80/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (string)
  id of the profile



### Body: application/json (object)

- **id** (integer)
  id of the public link

- **page_id** (integer)
  id of the form the link belongs to

- **name** (string)

- **label** (string)

- **activation_date** (string)

- **expiration_date** (string)

- **is_disabled** (boolean)

- **password** (string | null)
  a non-empty string sets a new password; `""` removes it; `null` or leaving the key out keeps the current one



## Responses
### 200
OK - every item was updated. The body is always an array, in request order.

#### Body: application/json (array[object])
- **id** (integer)
  id of the public link

- **error_message** (string)
  why this item failed


### 207
Multi-Status - some items were updated and some failed. Each failed item carries `error_message`.

#### Body: application/json (array[object])
- **id** (integer)
  id of the public link

- **error_message** (string)
  why this item failed


### 400
Bad Request - every item failed (for example neither `id` nor `page_id`, no link matches them, or public links are not enabled on this server). The body is the same array, with `error_message` on each item.

#### Body: application/json (array[object])
- **id** (integer)
  id of the public link

- **error_message** (string)
  why this item failed


### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - the caller cannot modify the form of one of the links in the body (see Authorization), or `profile_id` is not the caller's own profile. Nothing is updated.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure



[Powered by Bump.sh](https://bump.sh)
