Passer au contenu principal
GET
/
files
/
v3
/
files
/
{fileId}
Récupérer un fichier par un ID
curl --request GET \
  --url https://api.hubapi.com/files/v3/files/{fileId} \
  --header 'Authorization: Bearer <token>'
{
  "access": "HIDDEN_INDEXABLE",
  "archived": true,
  "createdAt": "2023-11-07T05:31:56Z",
  "id": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z",
  "archivedAt": "2023-11-07T05:31:56Z",
  "defaultHostingUrl": "<string>",
  "encoding": "<string>",
  "expiresAt": 123,
  "extension": "<string>",
  "fileMd5": "<string>",
  "height": 123,
  "isUsableInContent": true,
  "name": "<string>",
  "parentFolderId": "<string>",
  "path": "<string>",
  "size": 123,
  "sourceGroup": "CONTENT",
  "type": "<string>",
  "url": "<string>",
  "width": 123
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit
Cette API requiert l'une des portées suivantes :
files
files.ui_hidden.read

Autorisations

​
Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Paramètres de chemin

​
fileId
string
requis

ID du fichier souhaité.

Pattern: \d+

Paramètres de requête

​
properties
string[]

Réponse

successful operation

File

​
access
enum<string>
requis

PUBLIC_INDEXABLE : le fichier est accessible publiquement par les personnes possédant l'URL. Les moteurs de recherche peuvent indexer le fichier. PUBLIC_NOT_INDEXABLE : le fichier est accessible publiquement par les personnes possédant l'URL. Les moteurs de recherche ne peuvent pas indexer le fichier. PRIVATE : le fichier n'est PAS accessible publiquement. Une URL signée est nécessaire pour voir le contenu. Les moteurs de recherche ne peuvent pas indexer le fichier.

Options disponibles:
HIDDEN_INDEXABLE,
HIDDEN_NOT_INDEXABLE,
HIDDEN_PRIVATE,
HIDDEN_SENSITIVE,
PRIVATE,
PUBLIC_INDEXABLE,
PUBLIC_NOT_INDEXABLE,
SENSITIVE
​
archived
boolean
requis

Indique si le dossier est supprimé ou non.

​
createdAt
string<date-time>
requis

Horodatage de la création du dossier.

​
id
string
requis

ID du fichier.

​
updatedAt
string<date-time>
requis

Horodatage de la dernière mise à jour du dossier.

​
archivedAt
string<date-time>

Horodatage de la suppression du dossier.

​
defaultHostingUrl
string

URL d'hébergement par défaut du fichier. Cela utilisera l'une des URL fournies par HubSpot pour gérer le fichier.

​
encoding
string

Encodage du fichier.

​
expiresAt
integer<int64>
​
extension
string

Extension du fichier demandé.

​
fileMd5
string

Le hachage MD5 du fichier.

​
height
integer<int32>

Pour les fichiers image et vidéo. La hauteur du fichier.

​
isUsableInContent
boolean

Indiquez si le fichier doit être utilisé dans le nouveau contenu ou non.

​
name
string

Nouveau nom. Si spécifié, le nom du dossier et fullPath changeront. Tous les dossiers enfants seront mis à jour en conséquence.

​
parentFolderId
string

Nouvel ID de dossier parent. S'il est modifié, le dossier et tous les dossiers enfants seront déplacés dans le dossier spécifié. parentFolderId et parentFolderPath ne peuvent pas être spécifiés en même temps

​
path
string

Chemin d'accès du dossier dans le gestionnaire de fichiers.

​
size
integer<int64>

Taille en octets du fichier demandé.

​
sourceGroup
enum<string>
Options disponibles:
CONTENT,
CONVERSATIONS,
FORMS,
UI_EXTENSIONS,
UNKNOWN
​
type
string

Type de fichier. Peut être IMG, DOCUMENT, AUDIO, MOVIE ou OTHER.

​
url
string

URL pour télécharger le nouveau fichier.

​
width
integer<int32>

Pour les fichiers image et vidéo. La largeur du fichier.

Last modified on February 12, 2026