Add external file to Library

post

https://api.seismic.com/cm/v1/teamSites/{teamSiteId}/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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

teamSiteId

string

required

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.

externalSource

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:

externalContentId

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).

parentFolderId

string

required

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.

autoSync

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

`403` in legacy environments.

`seismic.library.manage` scope or lacks write permission on the target folder. In some legacy environments, expired or missing authentication may also surface as `403`; clients should handle both `401` and `403` for auth-related failures.

Request body samples

200The external file was successfully imported into the Seismic Library. The response contains the new Seismic content identifier for the created item.

400Bad Request. The request body is missing required fields, contains invalid values, or references an unsupported external source.

401Unauthorized. The request is missing a valid authentication token or the token has expired. For backward compatibility, clients should also handle equivalent auth failures returned as 403 in legacy environments.

403Forbidden. The caller does not have the seismic.library.manage scope or lacks write permission on the target folder. In some legacy environments, expired or missing authentication may also surface as 403; clients should handle both 401 and 403 for auth-related failures.

404Not Found. The specified teamsite, parent folder, external Google Drive connection, or external file could not be resolved.

500Internal Server Error. An unexpected error occurred on the server while importing the external content.

`403` in legacy environments.

`seismic.library.manage` scope or lacks write permission on the target folder. In some legacy environments, expired or missing authentication may also surface as `403`; clients should handle both `401` and `403` for auth-related failures.