GuidesAPI DocsChangelogMy AppsSeismic Exchange
API Docs

Add external file to Library

post
https://api.seismic.com/cm/v1/teamSites//external/contents

Add an external file from a supported cloud source (currently Google Drive) to the Seismic Library under the specified teamsite. The operation creates a new Library content item linked to the external source file and places it in the target parent folder.

Domain Terms

  • externalSource: The cloud storage platform where the source file lives. Only GoogleDrive is supported at this time.
  • externalContentId: The unique file identifier in the external source system (e.g., a Google Drive file ID such as 1XK_AinrjCzyylNGaH6oX9MUfY5-G-Y54).
  • parentFolderId: The Seismic Library folder that will contain the new content item. Use a folder GUID or root for the top-level Library folder.
  • autoSync: When true, the Library item re-syncs automatically whenever the source file is updated in Google Drive.

Prerequisites

  • The caller must have a valid Google Drive connection configured in Seismic.
  • The target parentFolderId must exist in the specified teamsite.
  • The external file identified by externalContentId must be accessible via the caller's Google Drive connection.

Rate Limit

This operation is rate-limited to 1 request per second per token.

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 the documented special value 1 for the default teamsite.

Body Params

Request body specifying the external source file to import and where to place it in the Seismic Library.

Request body samples

{
  "externalSource": "GoogleDrive",
  "externalContentId": "1XK_AinrjCzyylNGaH6oX9MUfY5-G-Y54",
  "parentFolderId": "6604995b-65c8-460c-abf4-2c0512292aeb",
  "autoSync": true
}

Request model for importing an external cloud source file into the Seismic Library. Currently only Google Drive is supported as an external source.

string
enum
required

The cloud storage platform that hosts the source file. The only currently supported value is GoogleDrive. Additional sources may be added in future API versions.

Allowed:
string
required

The unique identifier of the file in the external source system. For Google Drive, this is the file ID visible in the shareable URL (e.g., 1XK_AinrjCzyylNGaH6oX9MUfY5-G-Y54).

string
required
^(?:root|[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})$

The identifier of the Seismic Library folder where the imported content will be placed. Use a folder GUID for a specific subfolder, or root for the top-level Library folder of the teamsite.

boolean
Defaults to false

When true, the Seismic Library item will automatically re-sync whenever the linked source file is updated in the external system. Set to false (or omit the field) to import the file as a one-time snapshot without ongoing synchronization. The backend defaults this value to false when the field is omitted from the request body.

Responses

Updated 22 days ago

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

Updated 22 days ago

Did this page help you?