Change folder information

patch

https://api.seismic.com/integration/v2/teamsites/{teamsiteId}/folders/{libraryContentId}

Updates metadata for an existing Library folder in the specified teamsite. Use this endpoint to rename a folder, move it to a different parent folder, or update external system mapping identifiers used by integrations.

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 a documented special value such as 1.

libraryContentId

uuid

required

Identifier of the library content item targeted by the operation. For folder-specific endpoints, this must identify folder content.

Body Params

Payload containing one or more folder metadata fields to update.

Request payload for updating folder metadata fields in a teamsite context.

name

string

length between 1 and 255

New display name for the folder. Provide a non-empty UTF-8 string used in Library navigation and search.

parentFolderId

string

Identifier of the destination or current parent folder. Can be root when content is at top level, otherwise folder GUID format.

externalId

string

length ≤ 255

Optional external identifier used to correlate this folder with a record in an external system.

externalConnectionId

string

length ≤ 255

Optional external connection identifier associated with the externalId mapping source.

Headers

Content-Type

string

MIME type header for the request payload. For this operation, send application/json.

string

enum

Defaults to application/json; charset=utf-8

Generated from available response content types

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json; charset=utf-8

application/json

200OK. Returns the latest folder metadata after the update is applied.

400Bad Request. One or more identifiers or request fields are malformed

401Unauthorized. The request is missing a bearer token, or the token is invalid or expired.

403Forbidden. The caller is authenticated but does not have the seismic.library.manage scope required to modify this folder.

404Not Found. The targeted teamsite, folder, file, item, or workflow could not be located by the provided identifier.

500Internal Server Error. An unexpected server-side error occurred while processing the request.

504Gateway Timeout. The upstream service did not respond in time, or is temporarily unavailable. Safe to retry after a brief delay.