/api/collections/{collection.name}/records/:id
Update a single {collection.name} record.
Body parameters could be sent as application/json
or
multipart/form-data
.
File upload is supported only via multipart/form-data
.
For more info and examples you could check the detailed
Files upload and handling docs
.
/api/collections/{collection.name}/records/:id
Requires admin Authorization:TOKEN
header
Param | Type | Description |
---|---|---|
id | String | ID of the record to update. |
Param | Type | Description |
---|---|---|
Auth fields | ||
Optional
username
|
String | The username of the auth record. |
Optional
email
|
String |
The auth record email address.
This field can be updated only by admins or auth records with "Manage" access. Regular accounts can update their email by calling "Request email change". |
Optional
emailVisibility
|
Boolean | Whether to show/hide the auth record email when fetching the record data. |
Optional
oldPassword
|
String |
Old auth record password.
This field is required only when changing the record password. Admins and auth records with "Manage" access can skip this field. |
Optional
password
|
String | New auth record password. |
Optional
passwordConfirm
|
String | New auth record password confirmation. |
Optional
verified
|
Boolean |
Indicates whether the auth record is verified or not.
This field can be set only by admins or auth records with "Manage" access. |
Schema fields | ||
{#if field.required}
Required
{:else}
Optional
{/if}
{field.name}
|
{CommonHelper.getFieldValueType(field)} |
{#if field.type === "text"}
Plain text value.
{:else if field.type === "number"}
Number value.
{:else if field.type === "json"}
JSON array or object.
{:else if field.type === "email"}
Email address.
{:else if field.type === "url"}
URL address.
{:else if field.type === "file"}
File object. Set to null to delete already uploaded file(s).
{:else if field.type === "relation"}
Relation record {field.options?.maxSelect > 1 ? "ids" : "id"}.
{:else if field.type === "user"}
User {field.options?.maxSelect > 1 ? "ids" : "id"}.
{/if}
|
Param | Type | Description |
---|---|---|
expand | String |
Auto expand relations when returning the updated record. Ex.:
The expanded relations will be appended to the record under the expand property (eg. {`"expand": {"relField1": {...}, ...}`} ). Only
the relations that the user has permissions to view will be expanded.
|