Advanced

Create or update a file

Changed on

Upserts a file at the specified path in the specified environment. Accepts multipart/form-data content type.

put/cms/source-code/2026-09/{environment}/content/{path}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/cms/source-code/2026-09/{environment}/content/{path}
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: content

Path parameters

environmentstring required

The environment in which the content file resides, such as 'staging' or 'production'.

pathstring required

The specific path to the content file within the environment.

Request body multipart/form-data

filestring binary

Response

successful operation

archivedAtinteger

Timestamp of when the object was archived (deleted).

childrenstring[]

If the object is a folder, contains the filenames of the files within the folder.

createdAtinteger required

Timestamp of when the object was first created.

folderboolean required

Determines whether or not this path points to a folder.

hashstring

A unique identifier for the file's content, used to verify data integrity.

idstring required

The path of the file in the CMS Developer File System.

namestring required

The name of the file.

updatedAtinteger required

Timestamp of when the object was last updated.

Changes