Discourse Extended icon

Discourse Extended

Read and manage Discourse AI artifacts, categories, posts, topics, personal messages, uploads, and Data Explorer queries

Actions25

Upload → Create From Source URL

AI-generated

Summary

Create a new Discourse upload from a presigned or publicly accessible source URL by specifying the URL and optional parameters such as filename, type, and user ID (if avatar).

Inputs

  • Source URL (required) — Presigned or publicly accessible URL for the source object to upload.
  • Original Filename — Optional override for the filename sent to Discourse.
  • Type — Specifies the upload type in Discourse, such as Avatar, Card Background, Composer (default), Custom Emoji, or Profile Background.
  • Synchronous — Whether to wait for the upload processing to complete and return detailed upload information.
  • User ID — Required when Type is Avatar; the user ID to assign the avatar upload to.
  • Additional Fields — Optional flags including For Private Message, For Site Setting, and Pasted, to specify upload context and metadata.
  • Simplify — Whether to return a simplified version of the API response instead of the raw data.

Output shape

a single JSON object representing the created upload

Returns either the raw API response or a simplified object based on the Simplify parameter. If Synchronous is true, waits for processing to complete; otherwise may return immediately with partial data.

Examples

Example 1: Upload a custom emoji from a public URL, specifying original filename and wait for completion.

Set Source URL to the public URL of the emoji, Type to Custom Emoji, Original Filename if needed, Synchronous true, Simplify true.

Links

Discussion