> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Update a course
> Realiza una actualización parcial de un objeto identificado por `{courseId}` o, de manera opcional, a cualquier valor de propiedad único según lo especificado por el parámetro de consulta `idProperty`. `{courseId}` se refiere al ID de objeto interno de manera predeterminada y el parámetro de consulta `idProperty` se refiere a una propiedad cuyos valores son únicos para el objeto. Se sobrescribirán los valores de propiedad especificados. Las propiedades de solo lectura y las no existentes generarán un error. Los valores de las propiedades pueden borrarse pasando una cadena vacía.
export const ScopesList = ({scopes = [], description = "Esta API requiere uno de los siguientes ámbitos:"}) => {
if (!scopes || scopes.length === 0) {
return null;
}
const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
return
;
};
## OpenAPI
````yaml specs/2026-03/crm-courses-v2026-03.json PATCH /crm/objects/2026-03/0-410/{courseId}
openapi: 3.0.1
info:
title: Cursos
description: Basepom for all HubSpot Projects
version: 2026-03
x-hubspot-product-tier-requirements:
marketing: FREE
sales: FREE
service: FREE
cms: FREE
commerce: FREE
crmHub: FREE
dataHub: FREE
x-hubspot-introduction: >-
Usa la API de cursos para crear y gestionar registros CRM que representan
información sobre un programa estructurado o una serie de lecciones,
actividades de formación o módulos educativos. Identifica el tipo de objeto
de cursos con su ID de tipo de objeto 0-410
servers:
- url: https://api.hubapi.com
security: []
tags:
- name: Advanced
- name: Basic
- name: Batch
- name: Search
paths:
/crm/objects/2026-03/0-410/{courseId}:
patch:
tags:
- Basic
summary: Actualizar un curso
description: >-
Realiza una actualización parcial de un objeto identificado por
`{courseId}` o, de manera opcional, a cualquier valor de propiedad único
según lo especificado por el parámetro de consulta `idProperty`.
`{courseId}` se refiere al ID de objeto interno de manera predeterminada
y el parámetro de consulta `idProperty` se refiere a una propiedad cuyos
valores son únicos para el objeto. Se sobrescribirán los valores de
propiedad especificados. Las propiedades de solo lectura y las no
existentes generarán un error. Los valores de las propiedades pueden
borrarse pasando una cadena vacía.
operationId: patch-/crm/objects/2026-03/0-410/{courseId}
parameters:
- name: courseId
in: path
required: true
schema:
pattern: .+
type: string
- name: idProperty
in: query
description: >-
El nombre de una propiedad cuyos valores son únicos para este tipo
de objeto
required: false
style: form
explode: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SimplePublicObjectInput'
required: true
responses:
'200':
description: successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/SimplePublicObject'
default:
$ref: '#/components/responses/Error'
description: ''
security:
- oauth2:
- crm.objects.courses.write
components:
schemas:
SimplePublicObjectInput:
required:
- properties
type: object
properties:
properties:
type: object
additionalProperties:
type: string
description: >-
Un objeto que contiene pares clave-valor, donde cada clave es un
nombre de propiedad y cada valor es una cadena que representa el
valor de la propiedad.
description: >-
Representa la entrada necesaria para crear o actualizar un objeto de
CRM, que contiene un objeto con nombres de propiedades y sus valores
correspondientes.
SimplePublicObject:
required:
- archived
- createdAt
- id
- properties
- updatedAt
type: object
properties:
archived:
type: boolean
description: Un booleano que indica si este objeto está archivado.
archivedAt:
type: string
description: La fecha y hora en que se archivó este objeto, en formato ISO 8601.
format: date-time
createdAt:
type: string
description: La fecha y hora en que se creó este objeto, en formato ISO 8601.
format: date-time
id:
type: string
description: El identificador único de este objeto, representado como una cadena.
objectWriteTraceId:
type: string
description: >-
Un identificador de cadena que se usa para rastrear las operaciones
de escritura en este objeto.
properties:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de propiedades y sus valores, donde cada valor es
una cadena.
propertiesWithHistory:
type: object
additionalProperties:
type: array
items:
$ref: '#/components/schemas/ValueWithTimestamp'
description: >-
Un mapa de nombres de propiedades con sus valores históricos, donde
cada valor es un conjuntos de objetos que contiene el valor y la
marca de tiempo.
updatedAt:
type: string
description: >-
La fecha y hora de la última actualización de este objeto, en
formato ISO 8601.
format: date-time
url:
type: string
description: Una cadena que representa la URL asociada a este objeto.
warnings:
type: array
description: >-
Un conjunto de advertencias relacionadas con este objeto, donde cada
advertencia contiene una categoría, mensaje y contexto.
items:
$ref: '#/components/schemas/PublicObjectWarning'
description: Un objeto público simple.
ValueWithTimestamp:
required:
- sourceType
- timestamp
- value
type: object
properties:
sourceId:
type: string
description: Una cadena que representa el identificador único de la fuente.
sourceLabel:
type: string
description: Una cadena que proporciona una etiqueta o descripción de la fuente.
sourceType:
type: string
description: >-
Una cadena que indica el tipo de fuente de la que se originó el
valor.
timestamp:
type: string
description: La fecha y hora en que se registró el valor, en formato ISO 8601.
format: date-time
updatedByUserId:
type: integer
description: >-
Un número entero que representa el ID del usuario que actualizó el
valor por última vez.
format: int32
value:
type: string
description: Una cadena que representa el valor de los datos.
description: Modelo de propiedad que incluye marca de tiempo.
PublicObjectWarning:
required:
- category
- context
- message
type: object
properties:
category:
type: string
description: Una cadena que representa la categoría de la advertencia.
context:
type: object
additionalProperties:
type: string
description: >-
Un objeto que proporciona contexto adicional para la advertencia,
con propiedades de cadena.
message:
type: string
description: Una cadena que contiene un mensaje de advertencia.
Error:
required:
- category
- correlationId
- message
type: object
properties:
category:
type: string
description: >-
La categoría del error, que proporciona una clasificación general
del error.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición de error, representado como un objeto
con propiedades adicionales que son secuencias de cadenas.
example: >-
{invalidPropertyName=[propertyValue], missingScopes=[scope1,
scope2]}
correlationId:
type: string
description: >-
Un identificador único de la solicitud. Incluye este valor en
cualquier informe de error o ticket de asistencia. Formato: UUID.
format: uuid
example: aeb5f871-7f07-4993-9211-075dc63e7cbf
errors:
type: array
description: >-
Más información sobre el error, proporcionada como un conjunto de
objetos ErrorDetail.
items:
$ref: '#/components/schemas/ErrorDetail'
links:
type: object
additionalProperties:
type: string
description: >-
Un mapa de nombres de enlaces a URI asociadas que contienen
documentación sobre el error o los pasos recomendados para
solucionarlo.
message:
type: string
description: >-
Un mensaje legible en el que se describa el error y los pasos para
solucionarlo, si procede.
example: An error occurred
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos acerca
del error.
description: >-
Representa una respuesta de error que devuelve la API cuando una
operación falla. Este componente se usa en varios puntos de terminación
para dar información detallada sobre el error que se encontró.
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
ErrorDetail:
required:
- message
type: object
properties:
code:
type: string
description: >-
El código de estado asociado con el detalle del error. Esta es una
propiedad de cadena.
context:
type: object
additionalProperties:
type: array
items:
type: string
description: >-
Contexto sobre la condición de error, representado como un objeto
con propiedades adicionales que son secuencias de cadenas.
example: '{missingScopes=[scope1, scope2]}'
in:
type: string
description: >-
El nombre del campo o parámetro en el que se encontró el error. Esta
es una propiedad de cadena.
message:
type: string
description: >-
Un mensaje comprensible para los humanos que describe el error,
junto con los pasos de solución cuando corresponda. Esta es una
propiedad de cadena obligatoria.
subCategory:
type: string
description: >-
Una categoría específica que contiene detalles más concretos sobre
el error. Esta es una propiedad de cadena.
description: >-
Representa información detallada sobre un error que ocurrió en la API.
Este componente se usa para dar contexto adicional y detalles
específicos sobre los errores, normalmente como parte de una respuesta
de error.
responses:
Error:
description: An error occurred.
content:
'*/*':
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://app.hubspot.com/oauth/authorize
tokenUrl: https://api.hubapi.com/oauth/v1/token
scopes:
crm.objects.commercepayments.read: ''
crm.objects.courses.read: ''
crm.objects.courses.write: ''
oauth: ''
````
{product.name} -
{product.level}
)}