# Modify an element

**PATCH /elements**

This endpoint allows you to modify an element of a request.


## Servers
- Production server.: https://api.usecollect.com/v1 (Production server.)


## Authentication methods
- Basic auth


## Parameters



### Body: application/json (object)

- **elementId** (string)
  The ID of the element you want to modify.
- **name** (string)
  Name of the element.
- **order** (integer)
  Order of the element on the portal. Order should be an integer and starts at 0.
- **visibility** (boolean)
  Define is this element is visible on the portal. Default is true.
- **status** (string)
  The new status of the element. Can be one of the predifined status open, waiting, approved,rejected.
- **reason** (string)
  If the new status is rejected, you can specify a reason that will be displayed on the portal.
- **description** (string)
  Description of the document that needs to be uploaded
- **nickname** (string)
  A nickname for this element. Can be useful to classify your uploaded docs.
- **path** (string)
  A path for this element. Can be useful to classify your uploaded docs.
- **mandatory** (boolean)
  Is the document mandatory or not. Default is true.
- **extensions** (array[string])
  A list of document extensions that are accepted. By default, all type of documents are accepted. Must be formated as a string like ['xls','xslx'].
- **multipleupload** (boolean)
  Specify if you are accepting multi documents for the same element. Default is true.


## Responses
### 200
OK

#### Body: application/json (object)
- **id** (string)
  Element ID
- **itemId** (string)
  Reference of the element in the campaign
- **name** (string)
  Element name
- **order** (integer)
  Element order
- **status** (string)
  Element status
- **mandatory** (boolean)
  Whether element is mandatory
- **multipleupload** (boolean)
  Whether multiple uploads are allowed
- **uploads** (array[object])

- **type** (string)
  Element type
- **request** (object)


### 400
Bad Request -- Your request is invalid.

### 401
Unauthorized -- Your API key is wrong.

### 403
Forbidden -- The object requested is hidden for administrators only.

### 404
Not Found -- The specified object could not be found.

### 429
Too Many Requests -- You're requesting too many objects! Slow down!

### 500
Internal Server Error -- We had a problem with our server. Try again later.

### 503
Service Unavailable -- We're temporarily offline for maintenance. Please try again later.


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