Create a file group | Uploadcare docs

Create a file group from a set of already uploaded files. The most common use case for creating a file group is when a user uploads multiple files at once and then wants to display them together. **Note:** A group itself and files within it MUST belong to the same project. **Note:** Groups are immutable and the only way to add/remove a file to a group is to create a new one.

Create a file group from a set of already uploaded files.

The most common use case for creating a file group is when a user uploads multiple files at once and then wants to display them together.

Note: A group itself and files within it MUST belong to the same project.

Note: Groups are immutable and the only way to add/remove a file to a group is to create a new one.

Request

This endpoint expects a multipart form.

pub_keystringRequired

Public key identifying an Uploadcare project your uploads will go to.

files[]list of stringsRequired

Set of files you want to add to the group. Each element can be a file UUID with or without the applied image processing operations.

signaturestringOptional

signature must be sent along with your upload request if you would like to use signed uploads. The signature should be generated on your backend. Note: the process requires knowledge of your Uploadcare Project’s Secret key. See signed uploads for details.

expireintegerOptional

expire must be sent along with your upload request if you would like to use signed uploads. The parameter defines the time during which your signature is valid. It’s a UNIX timestamp. See signed uploads for details.

Response

The group was created successfully.

idstring

Group's unique ID.

datetime_createddatetime

ISO-8601 date and time when the group was created.

files_countinteger

Number of the files in the group.

cdn_urlstringformat: "uri"

Group's CDN URL.

urlstringformat: "uri"

Group’s API resource URL. See the REST API documentation for details.

fileslist of any or null

The list of files in the group. An array may contain null values if a file has been removed.

datetime_storeddatetime or nullDeprecated

Deprecated. This field will be removed in a future version of the Upload API.