POST
TypeScript client

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Body

application/json
sourceUrl
string

Public http(s) URL the server fetches the file from (SSRF-guarded, max 200 MB); mutually exclusive with contentBase64.

Minimum string length: 1
Example:

"https://example.com/media/launch-teaser.png"

contentBase64
string

Base64-encoded file content for small payloads, max 10 MB decoded; mutually exclusive with sourceUrl, and requires fileName and mimeType.

Minimum string length: 1
Example:

"iVBORw0KGgoAAAANSUhEUg..."

fileName
string

Filename to store the asset under, including extension; required with contentBase64, otherwise derived from sourceUrl.

Minimum string length: 1
Example:

"launch-teaser.png"

mimeType
string

MIME type of the imported content; required with contentBase64, otherwise inferred from the fetch response.

Minimum string length: 1
Example:

"image/png"

folderId
string<uuid>

Folder to place the newly imported asset in; must exist and belong to the team. Omit to land the asset at the team root.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$

Response

Success

asset
object
required
deduplicated
boolean
required