AI agents for Uploadcare

List files

Lists the project's files, oldest first unless ordered -datetime_uploaded, optionally only stored or only temporary ones, or from an upload time on.

Search files

Finds files by text in their names, metadata or MIME type (at least 4 characters), or pastes a UUID to find that file.

Get a file

Reads one file by UUID: original_filename, mime_type, size, is_image, is_ready, datetime_uploaded and datetime_stored, content_info.

Check a background removal

Reads the state of a remove_background request: status (in_progress, done, error or unknown) and, once done, result.file_id, the UUID of the new image.

Check a conversion

Reads a document conversion job by its token: status (pending, processing, finished, failed or canceled), error, and result.uuid of the converted file.

Store a file

Keeps a file permanently; files not stored are deleted 24 hours after upload (unless the project stores automatically).

Delete a fileDeletes data

Deletes a file from storage; its links stop working.

Set a file's metadata value

Sets one metadata key on a file (created if new), like an order number or the customer a file belongs to; metadata is searchable with search_files.

Remove an image's background

Starts remove.bg background removal on an image (an Uploadcare add-on billed per use), optionally cropping to the subject, adding a margin or a shadow.

Convert a document

Converts a document to another format (pdf, docx, odt, rtf, txt, xlsx, jpg, png and more, by what the source allows; a single page as an image with page).