Add a new version of a URL's attached file

Adds a new version of the source file attached to an existing URL content item, rather than replacing the attachment in place. Uses POST instead of PUT because the operation is not idempotent — each call creates a new version of the URL content item.

The request body is multipart/form-data with two parts: a metadata part containing a JSON string describing the URL content item's metadata (the same shape accepted when creating a URL content item), and an attachment part containing the binary file to attach as the new version's source file, such as an exported PDF or image rendition of the linked content.

Glossary: attachment — A binary source file associated with a URL content item, distinct from the url.url link itself, typically used to provide a downloadable or previewable rendition of externally hosted content (for example, a Canva design export).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
^(?:1|[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})$

Identifier of the teamsite context for the request. Depending on API behavior, it may be a GUID-formatted value or a documented special value such as 1.

string
required
^[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}$

Identifier of the existing URL content item whose attachment will receive a new version.

Body Params

Multipart form containing the URL content item's metadata as a JSON string plus the binary file to attach as the new version's source file.

string
required

JSON string containing the URL content item's metadata, including required name and url fields and optional properties such as externalId, externalConnectionId, externalResourceId, attachmentType, thumbnailBlobId, thumbnailBase64, and retrieveSiteInfo. See the discoverable Seismic.LibraryContentManagement.AddANewVersionOfAUrlsAttachmentRequest schema for the full structure including field types, constraints, and validation rules.

file
required

The binary file to attach to the URL content item as the new version's source file, such as an exported PDF or image rendition of the linked content. Must be non-empty.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json