Create an url

post

https://api.seismic.com/integration/v2/workspace/urls

Create a new URL content item in the user's workspace. The URL becomes immediately accessible to the creating user and inherits permissions from the specified parent folder. Use this operation to save a web link as a shareable workspace item. Example: POST body {"name": "Q4 Report", "parentFolderId": "root", "url": {"url": "https://example.com/report"}} adds a URL to the root workspace folder.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

openInNewWindow

boolean

Defaults to false

When true, the URL opens in a new browser window; when false it opens in the current window.

Body Params

name

string

Display name for the new URL item as it will appear in the workspace.

parentFolderId

string

UUID of the parent folder where the URL item will be created. Use "root" to create it at the user's root level.

url

object

Object wrapping the actual web address the URL item should point to.

description

string

Optional human-readable description shown alongside the URL item in the workspace UI.

thumbnail

string

Optional base64 data URI for a custom thumbnail image; if omitted, a default icon is used.

mode

string

enum

Controls how the URL item is rendered when opened in a Seismic application.

Allowed:

Headers

Content-Type

string

MIME type of the request body; must be 'application/json' for this endpoint.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200OK

400Bad Request - the request body contains invalid or missing required fields. Validate the JSON payload against the operation schema (including required fields, value formats, and enum values) before retrying.

401Unauthorized - authentication credentials are missing, expired, or invalid. Acquire a fresh OAuth 2.0 bearer token and retry with the Authorization header set.

403Forbidden - the authenticated user lacks permission to perform this operation. Verify the required scope is granted and that the user has the necessary role on the target resource before retrying.