> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve schemas

> Récupérer les schémas associés à une application spécifique dans le compte HubSpot. Ce point de terminaison vous permet de récupérer les détails du schéma, ce qui peut être utile pour comprendre la structure des données et les propriétés associées à l'application. Vous pouvez éventuellement filtrer les résultats pour inclure uniquement les schémas archivés.

> **Supported products**

> **Required Scopes**


## OpenAPI

````yaml specs/2026-09/cms-media-bridge-v2026-09.json GET /media-bridge/2026-09/{appId}/schemas
openapi: 3.0.1
info:
  title: CMS Media Bridge
  description: Basepom for all HubSpot Projects
  version: 2026-09
  x-hubspot-product-tier-requirements:
    marketing: FREE
    sales: FREE
    service: FREE
    cms: FREE
    commerce: FREE
    crmHub: FREE
    dataHub: FREE
servers:
  - url: https://api.hubapi.com
security: []
tags:
  - name: Advanced
  - name: Basic
  - name: Batch
paths:
  /media-bridge/2026-09/{appId}/schemas:
    get:
      tags:
        - Basic
      summary: Récupérer les schémas
      description: >-
        Récupérer les schémas associés à une application spécifique dans le
        compte HubSpot. Ce point de terminaison vous permet de récupérer les
        détails du schéma, ce qui peut être utile pour comprendre la structure
        des données et les propriétés associées à l'application. Vous pouvez
        éventuellement filtrer les résultats pour inclure uniquement les schémas
        archivés.
      operationId: get-/media-bridge/2026-09/{appId}/schemas
      parameters:
        - name: appId
          in: path
          description: >-
            L'identifiant unique de l'application pour laquelle récupérer les
            schémas.
          required: true
          style: simple
          explode: false
          schema:
            type: integer
            format: int32
        - name: archived
          in: query
          description: S'il faut renvoyer uniquement les résultats qui ont été archivés.
          required: false
          style: form
          explode: true
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CollectionResponseObjectSchemaNoPaging'
        default:
          $ref: '#/components/responses/Error'
          description: ''
      security:
        - developer_hapikey: []
components:
  schemas:
    CollectionResponseObjectSchemaNoPaging:
      required:
        - results
      type: object
      properties:
        results:
          type: array
          description: >-
            Un tableau de schémas d'objets inclus dans la réponse. Chaque
            élément en est un.
          items:
            $ref: '#/components/schemas/ObjectSchema'
    ObjectSchema:
      required:
        - allowsSensitiveProperties
        - archived
        - associations
        - fullyQualifiedName
        - id
        - labels
        - name
        - objectTypeId
        - properties
        - requiredProperties
        - searchableProperties
        - secondaryDisplayProperties
      type: object
      properties:
        allowsSensitiveProperties:
          type: boolean
          description: Un booléen indiquant si l'objet autorise les propriétés sensibles.
        archived:
          type: boolean
          description: Un booléen indiquant si l'objet est archivé.
        associations:
          type: array
          description: >-
            Une référence aux associations de l'objet, qui sont définies
            ailleurs dans le schéma.
          items:
            $ref: '#/components/schemas/AssociationDefinition'
        createdAt:
          type: string
          description: >-
            Une chaîne au format date-heure indiquant la date de création de
            l'objet.
          format: date-time
        createdByUserId:
          type: integer
          description: Une chaîne représentant l'ID de l'utilisateur qui a créé l'objet.
          format: int32
        description:
          type: string
          description: Une chaîne fournissant une description de l'objet.
        fullyQualifiedName:
          type: string
          description: Une chaîne représentant le nom complet de l'objet.
        id:
          type: string
          description: Une chaîne représentant l'identifiant unique de l'objet.
        labels:
          $ref: '#/components/schemas/ObjectTypeDefinitionLabels'
        name:
          type: string
          description: Une chaîne représentant le nom de l'objet.
        objectTypeId:
          type: string
          description: Une chaîne représentant l'identifiant de type de l'objet.
        primaryDisplayProperty:
          type: string
          description: >-
            Une chaîne représentant la propriété principale utilisée pour
            afficher l'objet.
        properties:
          type: array
          description: >-
            Une référence aux propriétés de l'objet, qui sont définies ailleurs
            dans le schéma.
          items:
            $ref: '#/components/schemas/Property_1'
        requiredProperties:
          type: array
          description: >-
            Un tableau de chaînes de caractères représentant les propriétés
            requises pour l'objet.
          items:
            type: string
        searchableProperties:
          type: array
          description: >-
            Un tableau de chaînes indiquant les propriétés de l'objet qui
            peuvent faire l'objet d'une recherche.
          items:
            type: string
        secondaryDisplayProperties:
          type: array
          description: >-
            Un tableau de chaînes de caractères représentant des propriétés
            additionnelles utilisées pour l'affichage de l'objet.
          items:
            type: string
        updatedAt:
          type: string
          description: >-
            Une chaîne au format date-heure indiquant la dernière mise à jour de
            l'objet.
          format: date-time
        updatedByUserId:
          type: integer
          description: >-
            Une chaîne représentant l'ID de l'utilisateur ayant mis à jour
            l'objet en dernier.
          format: int32
    Error:
      required:
        - category
        - correlationId
        - message
      type: object
      properties:
        category:
          type: string
          description: La catégorie d'erreur
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexte concernant la condition d'erreur
          example: >-
            {invalidPropertyName=[propertyValue], missingScopes=[scope1,
            scope2]}
        correlationId:
          type: string
          description: >-
            Un identifiant unique pour la demande. Incluez cette valeur dans
            tous les rapports d'erreurs ou tickets d'assistance
          format: uuid
          example: aeb5f871-7f07-4993-9211-075dc63e7cbf
        errors:
          type: array
          description: informations supplémentaires à propos de l'erreur
          items:
            $ref: '#/components/schemas/ErrorDetail'
        links:
          type: object
          additionalProperties:
            type: string
          description: >-
            Une carte des noms de liens vers les URI associés contenant de la
            documentation sur l'erreur ou les mesures correctives recommandées
        message:
          type: string
          description: >-
            Un message lisible par la personne décrivant l'erreur ainsi que les
            mesures correctives possibles, le cas échéant
          example: An error occurred
        subCategory:
          type: string
          description: >-
            Une catégorie spécifique qui contient des détails plus précis sur
            l'erreur
      description: >-
        Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération
        échoue. Ce composant est utilisé dans divers points de terminaison pour
        fournir des informations détaillées sur l'erreur rencontrée.
      example:
        message: Invalid input (details will vary based on the error)
        correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf
        category: VALIDATION_ERROR
        links:
          knowledge-base: https://www.hubspot.com/products/service/knowledge-base
    AssociationDefinition:
      required:
        - fromObjectTypeId
        - id
        - toObjectTypeId
      type: object
      properties:
        createdAt:
          type: string
          description: >-
            La date et l'heure de création de cette définition d'association, au
            format ISO 8601.
          format: date-time
        fromObjectTypeId:
          type: string
          description: L'identifiant unique du type d'objet d'où provient l'association.
        id:
          type: string
          description: L'identifiant unique de cette définition d'association.
        name:
          type: string
          description: Le nom de l'association, qui sert d'identifiant lisible par l'homme.
        toObjectTypeId:
          type: string
          description: >-
            L'identifiant unique du type d'objet vers lequel l'association
            pointe.
        updatedAt:
          type: string
          description: >-
            La date et l'heure de la dernière mise à jour de cette définition
            d'association, au format ISO 8601.
          format: date-time
      description: The definition of an association
    ObjectTypeDefinitionLabels:
      type: object
      properties:
        plural:
          type: string
          description: >-
            Le libellé pluriel du type d'objet, utilisé pour représenter
            plusieurs instances de l'objet. Il s'agit d'une chaîne de
            caractères.
        singular:
          type: string
          description: >-
            Le libellé singulier pour le type d'objet, utilisé pour représenter
            une seule instance de l'objet. Il s'agit d'une chaîne de caractères.
    Property_1:
      required:
        - description
        - fieldType
        - groupName
        - label
        - name
        - options
        - type
      type: object
      properties:
        archived:
          type: boolean
          description: Un booléen indiquant si la propriété est archivée.
        archivedAt:
          type: string
          description: La date et l'heure d'archivage de la propriété, au format ISO 8601.
          format: date-time
        calculated:
          type: boolean
          description: Un booléen indiquant si la propriété est calculée.
        calculationFormula:
          type: string
          description: >-
            La formule utilisée pour calculer la valeur de la propriété, le cas
            échéant.
        createdAt:
          type: string
          description: La date et l'heure de création de la propriété, au format ISO 8601.
          format: date-time
        createdUserId:
          type: string
          description: L'ID de l'utilisateur qui a créé la propriété.
        currencyPropertyName:
          type: string
          description: Le nom de la propriété de devise associée à cette propriété.
        dataSensitivity:
          type: string
          description: Le niveau de sensibilité des données contenues dans la propriété.
          enum:
            - highly_sensitive
            - non_sensitive
            - sensitive
        dateDisplayHint:
          type: string
          description: Une astuce pour l'affichage des propriétés de date.
          enum:
            - absolute
            - absolute_with_relative
            - time_since
            - time_until
        description:
          type: string
          description: Une description de la propriété.
        displayOrder:
          type: integer
          description: Un entier indiquant l'ordre d'affichage de la propriété.
          format: int32
        externalOptions:
          type: boolean
          description: Un booléen indiquant si les options de la propriété sont externes.
        fieldType:
          type: string
          description: "Le type de champ de la propriété, qui peut être l'un des suivants\_: «\_booleancheckbox\_», «\_calculation_equation\_», «\_checkbox\_», «\_date\_», «\_file\_», «\_html\_», «\_number\_», «\_phonenumber\_», «\_radio\_», «\_select\_», «\_text\_» ou «\_textarea\_»."
        formField:
          type: boolean
          description: Un booléen indiquant si la propriété est un champ de formulaire.
        groupName:
          type: string
          description: Le nom du groupe auquel appartient la propriété.
        hasUniqueValue:
          type: boolean
          description: Un booléen indiquant si la valeur de la propriété est unique.
        hidden:
          type: boolean
          description: Un booléen indiquant si la propriété est masquée.
        hubspotDefined:
          type: boolean
          description: Un booléen indiquant si la propriété est définie par HubSpot.
        label:
          type: string
          description: Le libellé d'affichage de la propriété.
        modificationMetadata:
          $ref: '#/components/schemas/PropertyModificationMetadata'
        name:
          type: string
          description: Le nom unique de la propriété.
        numberDisplayHint:
          type: string
          description: "Une indication pour l'affichage des propriétés numériques, qui peut être «\_non formatée\_», «\_formatée\_», «\_devise\_», «\_pourcentage\_», «\_durée\_» ou «\_probabilité\_»."
          enum:
            - currency
            - duration
            - formatted
            - percentage
            - probability
            - unformatted
        options:
          type: array
          description: >-
            Un ensemble d'options disponibles pour la propriété, applicable si
            le type de propriété est « énumération ».
          items:
            $ref: '#/components/schemas/Option_1'
        referencedObjectType:
          type: string
          description: Le type d'objet auquel la propriété fait référence, le cas échéant.
        sensitiveDataCategories:
          type: array
          description: Catégories de données sensibles associées à la propriété.
          items:
            type: string
        showCurrencySymbol:
          type: boolean
          description: >-
            Un booléen indiquant s'il faut afficher le symbole monétaire pour la
            propriété.
        textDisplayHint:
          type: string
          description: "Une indication pour l'affichage des propriétés de texte, qui peut être «\_unformatted_single_line\_», «\_multi_line\_», «\_email\_», «\_phone_number\_», «\_domain_name\_», «\_ip_address\_», «\_physical_address\_» ou «\_postal_code\_»."
          enum:
            - domain_name
            - email
            - ip_address
            - multi_line
            - phone_number
            - physical_address
            - postal_code
            - unformatted_single_line
        type:
          type: string
          description: "Le type de données de la propriété\_: «\_bool\_», «\_date\_», «\_datetime\_», «\_enumeration\_», «\_number\_», «\_phone_number\_» ou «\_string\_»."
        updatedAt:
          type: string
          description: >-
            La date et l'heure de la dernière mise à jour de la propriété, au
            format ISO 8601.
          format: date-time
        updatedUserId:
          type: string
          description: >-
            L'ID de l'utilisateur qui a mis à jour la propriété pour la dernière
            fois.
    ErrorDetail:
      required:
        - message
      type: object
      properties:
        code:
          type: string
          description: Le code du statut associé au détail de l'erreur
        context:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          description: Contexte concernant la condition d'erreur
          example: '{missingScopes=[scope1, scope2]}'
        in:
          type: string
          description: >-
            Le nom du champ ou du paramètre dans lequel l'erreur a été détectée.
            Il s'agit d'une propriété de type chaîne de caractères.
        message:
          type: string
          description: >-
            Un message lisible par la personne décrivant l'erreur ainsi que les
            mesures correctives possibles, le cas échéant
        subCategory:
          type: string
          description: >-
            Une catégorie spécifique qui contient des détails plus précis sur
            l'erreur
      description: >-
        Représente des informations détaillées sur une erreur survenue dans
        l'API. Ce composant est utilisé pour fournir un contexte et des
        spécificités supplémentaires sur les erreurs, généralement dans le cadre
        d'une réponse d'erreur.
    PropertyModificationMetadata:
      required:
        - archivable
        - readOnlyDefinition
        - readOnlyValue
      type: object
      properties:
        archivable:
          type: boolean
          description: Un booléen indiquant si la propriété peut être archivée.
        readOnlyDefinition:
          type: boolean
          description: >-
            Un booléen indiquant si la définition de la propriété est en lecture
            seule, ce qui signifie qu'elle ne peut pas être modifiée.
        readOnlyOptions:
          type: boolean
          description: >-
            Un booléen indiquant si les options de la propriété sont en lecture
            seule.
        readOnlyValue:
          type: boolean
          description: >-
            Un booléen indiquant si la valeur de la propriété est en lecture
            seule, ce qui signifie qu'elle ne peut pas être modifiée.
    Option_1:
      required:
        - hidden
        - label
        - value
      type: object
      properties:
        description:
          type: string
          description: >-
            Une chaîne fournissant des informations supplémentaires sur
            l'option.
        displayOrder:
          type: integer
          description: >-
            Un entier indiquant l'ordre dans lequel l'option doit être affichée
            par rapport aux autres options.
          format: int32
        hidden:
          type: boolean
          description: Un booléen indiquant si l'option est masquée de l'affichage.
        label:
          type: string
          description: >-
            Une chaîne de caractères représentant le libellé d'affichage de
            l'option.
        value:
          type: string
          description: Une chaîne représentant la valeur attribuée à l'option.
  responses:
    Error:
      description: An error occurred.
      content:
        '*/*':
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    developer_hapikey:
      type: apiKey
      name: hapikey
      in: query

````