Skip to content

HubSpot: Projects schemas

35 HubSpot schemas with complete fields and constraints.

← Projects operations · All schemas

Batch archive objects — projects batch Delete Projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input payload containing a list of simple public object IDs. This component is used when performing batch operations on multiple objects within HubSpot.
inputsarrayRequired within parentAn array of SimplePublicObjectId objects, each containing an ID of a CRM object to be processed. This property is required.
inputs[]ModelEach itemExpand Read batch objects — carts batch Get Carts — request body — body inputs item

Referenced models: Read batch objects — carts batch Get Carts — request body — body inputs item

Batch create objects — projects batch Create Projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input for creating multiple simple public objects in a single request. This component is used to streamline the process of adding new objects to a HubSpot account by allowing multiple entries to be created at once.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInputForCreate objects, each containing the properties and associations needed to create a CRM object.
inputs[]ModelEach itemExpand Batch create objects — projects batch Create Projects — request body — body inputs item

Referenced models: Batch create objects — projects batch Create Projects — request body — body inputs item

Batch create objects — projects batch Create Projects — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootAn input object that contains a collection of objects to be created together in a batch.
associationsarrayRequired within parentAn array of associations for the objects being created, where each association specifies the related object and the type of association.
associations[]ModelEach itemExpand Create — projects create Project — request body — body associations item
objectWriteTraceIdstringOptionalA string used to trace the write operation for debugging or logging purposes.
propertiesobjectRequired within parentAn object containing key-value pairs where keys are property names and values are the property values for the CRM objects being created.
Additional keys: see wildcard field
properties.*stringAdditional keys

Referenced models: Create — projects create Project — request body — body associations item

Batch read objects — projects batch Get Projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootSpecifies the input for reading a batch of CRM objects, including arrays of object IDs, requested property names (with optional history), and an optional unique identifying property.
idPropertystringOptionalA string representing the name of a property whose values are unique for the object type. This property is used to identify objects uniquely.
inputsarrayRequired within parentAn array of SimplePublicObjectId objects, each representing an object to be read in the batch operation.
inputs[]ModelEach itemExpand Read batch objects — carts batch Get Carts — request body — body inputs item
propertiesarrayRequired within parentAn array of strings specifying the properties to be returned for each object in the batch. If a specified property is not present on an object, it will be ignored.
properties[]stringEach item
propertiesWithHistoryarrayRequired within parentAn array of strings specifying the properties to be returned along with their history of previous values for each object in the batch. If a specified property is not present on an object, it will be ignored.
propertiesWithHistory[]stringEach item

Referenced models: Read batch objects — carts batch Get Carts — request body — body inputs item

Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item

FieldTypePresenceDescription and constraints
$objectRootRepresents a standard error response in the HubSpot API, providing detailed information about an error that occurred during an API request.
categorystringRequired within parentA string specifying the category of the error.
contextobjectRequired within parentAn object containing additional context about the error, where each key is a context name and the value is an array of strings.
Additional keys: see wildcard field
context.*arrayAdditional keys
context.*[]stringEach item
errorsarrayRequired within parentAn array of ErrorDetail objects, each providing further information about the error.
errors[]ModelEach itemExpand Batch insert events — response body — errors item errors item
idstringOptionalA string representing the unique identifier for the error.
linksobjectRequired within parentAn object mapping link names to associated URIs that contain documentation about the error or recommended remediation steps.
Additional keys: see wildcard field
links.*stringAdditional keys
messagestringRequired within parentA string containing a human-readable message that describes the error.
statusstringRequired within parentA string indicating the status of the error.
subCategoryobjectOptionalAn object providing more specific details about the error category.

Referenced models: Batch insert events — response body — errors item errors item

Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Projects Batch Response Simple Public Object

FieldTypePresenceDescription and constraints
$objectRootA public object batch response object
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
linksobjectOptionalA map of link names to associated URIs for additional information related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicObject items representing the results of the batch operation.
results[]ModelEach itemExpand Create — projects create Project — response body
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Create — projects create Project — response body

Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Projects Batch Response Simple Public Object With Errors

FieldTypePresenceDescription and constraints
$objectRootRepresents the result of a batch operation on CRM objects, including the processing status, batch results, timestamps, and a list of any errors encountered during the operation.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
errorsarrayOptionalAn array of errors encountered during the batch operation, each represented as a StandardError.
errors[]ModelEach itemExpand Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
linksobjectOptionalA map of link names to associated URIs, providing additional context or resources related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
numErrorsJSONOptional
numErrors (anyOf 1)integerAlternativeThe number of errors encountered during the batch operation.
Format: int32
numErrors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of results from the batch operation, each represented as a SimplePublicObject.
results[]ModelEach itemExpand Create — projects create Project — response body
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Create — projects create Project — response body, Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item

Create — projects create Project — request body — body

FieldTypePresenceDescription and constraints
$objectRootIs the input object used to create a new CRM object, containing the properties to be set and optional associations to link the new record with other CRM objects.
associationsarrayRequired within parentAn array of objects that define the associations between the new CRM object and other existing objects. Each association is specified by a 'PublicAssociationsForObject' object.
associations[]ModelEach itemExpand Create — projects create Project — request body — body associations item
propertiesobjectRequired within parentAn object containing key-value pairs where keys are property names and values are the corresponding property values for the CRM object. Each property is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys

Referenced models: Create — projects create Project — request body — body associations item

Create — projects create Project — request body — body associations item

FieldTypePresenceDescription and constraints
$objectRootRepresents the associations for a specific object in HubSpot, detailing the types of associations and the related objects involved.
toModelRequired within parentExpand Archive a batch of contacts — request body — body inputs item
typesarrayRequired within parentAn array of association specifications, each defining the type of association between the source and target objects. Each item in the array is an AssociationSpec object.
types[]ModelEach itemExpand Create meeting — request body — body associations item types item

Referenced models: Archive a batch of contacts — request body — body inputs item, Create meeting — request body — body associations item types item

Create — projects create Project — response body

FieldTypePresenceDescription and constraints
$objectRootA simple public object.
archivedbooleanRequired within parentA boolean indicating whether this object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
objectWriteTraceIdstringOptionalA string used to trace the write operations for this object.
propertiesobjectRequired within parentA map of property names to their values for this object, where each value is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to arrays of their historical values, where each historical value includes a timestamp and the value at that time.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — projects get Project — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalA string representing the URL of this object.
warningsarrayOptionalAn array of warnings related to this object, where each warning includes a category, message, and context.
warnings[]ModelEach itemExpand Read — projects get Project — response body — warnings item

Referenced models: Read — projects get Project — response body — warnings item, Read — projects get Project — response body — properties With History value item

List associations — projects get Associations By To Object Type — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a paginated collection of objects that are associated with multiple labels, including the results and pagination details. This component is used when retrieving associated objects with specific labels in a forward-paging manner.
pagingModelOptionalExpand List — projects get Projects — response body — paging
resultsarrayRequired within parentAn array of objects, each containing multiple associations and their respective labels. Each object includes the associated object ID and the types of associations with labels.
results[]ModelEach itemExpand List associations — projects get Associations By To Object Type — response body — results item

Referenced models: List — projects get Projects — response body — paging, List associations — projects get Associations By To Object Type — response body — results item

List associations — projects get Associations By To Object Type — response body — results item

FieldTypePresenceDescription and constraints
$objectRootRepresents an object that is associated with multiple other objects, with optional context.
associationTypesarrayRequired within parentAn array of association specifications, each including a label. These define the types of associations between the objects.
associationTypes[]ModelEach itemExpand List associations — projects get Associations By To Object Type — response body — results item association Types item
toObjectIdstringRequired within parentThe unique identifier of the object to which associations are being made. It is a string.

Referenced models: List associations — projects get Associations By To Object Type — response body — results item association Types item

List associations — projects get Associations By To Object Type — response body — results item association Types item

FieldTypePresenceDescription and constraints
$objectRootDefines the type, direction, and details of the relationship between two CRM objects.
categorystringRequired within parentA string representing the category of the association. Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED', 'INTEGRATOR_DEFINED', and 'WORK'.
Known values: HUBSPOT_DEFINED, INTEGRATOR_DEFINED, USER_DEFINED, WORK
fromObjectTypeIdstringOptionalA string representing the object type ID from which the association originates.
labelstringOptionalA string representing an optional label for the association.
toObjectTypeIdstringOptionalA string representing the object type ID to which the association is directed.
typeIdJSONRequired within parent
typeId (anyOf 1)integerAlternativeAn integer representing the unique identifier for the type of association.
Format: int32
typeId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

List — projects get Projects — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a paginated collection response that includes simple public objects with their associations. This component is used to handle the results and pagination details when retrieving a list of objects from the API.
pagingModelOptionalExpand List — projects get Projects — response body — paging
resultsarrayRequired within parentAn array of SimplePublicObjectWithAssociations, representing the CRM objects retrieved in the current page.
results[]ModelEach itemExpand Read — projects get Project — response body

Referenced models: List — projects get Projects — response body — paging, Read — projects get Project — response body

List — projects get Projects — response body — paging

FieldTypePresenceDescription and constraints
$objectRootPaging information for forward-only pagination. Contains the next page reference when more results are available; omitted or empty on the last page.
nextModelOptionalExpand List — projects get Projects — response body — paging next

Referenced models: List — projects get Projects — response body — paging next

List — projects get Projects — response body — paging next

FieldTypePresenceDescription and constraints
$objectRootSpecifies the paging information needed to retrieve the next set of results in a paginated API response
afterstringRequired within parentA string token used as a cursor to fetch the next page of results.
linkstringOptionalA string representing the URL link to the next page of results.

Read — projects get Project — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a CRM object along with its properties, timestamps, and a set of associated object IDs grouped by association type.
archivedbooleanRequired within parentA boolean indicating whether this object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
associationsobjectOptionalA map of associated object types to their associated IDs, providing links to related objects.
Additional keys: see wildcard field
associations.*ModelAdditional keysExpand Read — projects get Project — response body — associations value
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this CRM object.
objectWriteTraceIdstringOptionalA string used to trace the write operations for this object.
propertiesobjectRequired within parentA map of property names to their current values for this object.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to their values, including a history of changes with timestamps.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — projects get Project — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalThe URL for accessing this object.
warningsarrayOptionalAn array of warnings associated with this object, detailing any issues or considerations.
warnings[]ModelEach itemExpand Read — projects get Project — response body — warnings item

Referenced models: Read — projects get Project — response body — warnings item, Read — projects get Project — response body — associations value, Read — projects get Project — response body — properties With History value item

Read — projects get Project — response body — associations value

FieldTypePresenceDescription and constraints
$objectRootRepresents a collection of associated IDs returned by an API request, including pagination details for navigating through the results.
pagingModelOptionalExpand Search — projects search Projects — response body — paging
resultsarrayRequired within parentAn array of associated IDs, each represented by an object containing the ID and type. This property is required.
results[]ModelEach itemExpand Read — projects get Project — response body — associations value results item

Referenced models: Read — projects get Project — response body — associations value results item, Search — projects search Projects — response body — paging

Read — projects get Project — response body — associations value results item

FieldTypePresenceDescription and constraints
$objectRootContains the id and type of an association
idstringRequired within parentA string representing the unique identifier of the associated object.
typestringRequired within parentA string indicating the type of association, which categorizes the relationship between objects.

Read — projects get Project — response body — properties With History value item

FieldTypePresenceDescription and constraints
$objectRootProperty model that includes timestamp.
sourceIdstringOptionalA string representing the identifier of the source from which the value was obtained.
sourceLabelstringOptionalA string providing a label or name for the source of the value.
sourceTypestringRequired within parentA string specifying the type of source from which the value was obtained.
timestampstringRequired within parentA string in date-time format indicating when the value was recorded.
Format: date-time
updatedByUserIdJSONOptional
updatedByUserId (anyOf 1)integerAlternativeAn integer representing the ID of the user who last updated the value.
Format: int32
updatedByUserId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
valuestringRequired within parentA string representing the value of the property at the given timestamp.

Read — projects get Project — response body — warnings item

FieldTypePresenceDescription and constraints
$objectRootRepresents a warning message related to a public object in HubSpot, providing details about the nature and context of the warning.
categorystringRequired within parentA string representing the category of the warning.
contextobjectRequired within parentAn object providing additional context about the warning, with string properties.
Additional keys: see wildcard field
context.*stringAdditional keys
messagestringRequired within parentA string containing the warning message.

Search — projects search Projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootDescribes a search request
afterstringRequired within parentA string used as a paging cursor token to retrieve the next set of results in a paginated response.
filterGroupsarrayRequired within parentAn array of filter groups used to specify the criteria for searching objects. Each filter group contains filters that define the conditions objects must meet.
filterGroups[]ModelEach itemExpand Search — projects search Projects — request body — body filter Groups item
limitintegerRequired within parentAn integer specifying the maximum number of results to return.
Format: int32
propertiesarrayRequired within parentAn array of strings indicating which properties of the objects should be included in the search results.
properties[]stringEach item
querystringOptionalA string representing the search query to be applied to the objects.
sortsarrayRequired within parentAn array of strings specifying the properties by which the search results should be sorted.
sorts[]stringEach item

Referenced models: Search — projects search Projects — request body — body filter Groups item

Search — projects search Projects — request body — body filter Groups item

FieldTypePresenceDescription and constraints
$objectRootRepresents a group of filters used to query data within HubSpot. This component is used to define criteria for filtering records in various API endpoints.
filtersarrayRequired within parentAn array of filter objects. Each filter specifies a condition to be applied in the search query. This property is required.
filters[]ModelEach itemExpand Search — projects search Projects — request body — body filter Groups item filters item

Referenced models: Search — projects search Projects — request body — body filter Groups item filters item

Search — projects search Projects — request body — body filter Groups item filters item

FieldTypePresenceDescription and constraints
$objectRootDefines a single condition for searching CRM objects, specifying the property to filter on, the operator to use (such as equals, greater than, or contains), and the value(s) to compare against.
highValuestringOptionalAn optional upper bound value used in range-based filters. It is a string.
operatorstringRequired within parentThe operator that defines the type of comparison to be made. Valid values include 'EQ', 'NEQ', 'LT', 'LTE', 'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY', 'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN', and 'NOT_CONTAINS_TOKEN'.
One of: BETWEEN, CONTAINS_TOKEN, EQ, GT, GTE, HAS_PROPERTY, IN, LT, LTE, NEQ, NOT_CONTAINS_TOKEN, NOT_HAS_PROPERTY, NOT_IN
propertyNamestringRequired within parentThe name of the property to apply the filter on. It is a string.
valuestringOptionalThe specific value to compare against the property. It is a string.
valuesarrayOptionalAn array of string values used for filters that operate on multiple values, such as 'IN' or 'NOT_IN'.
values[]stringEach item

Search — projects search Projects — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a list of simple objects returned from an API request, along with the total count of objects available.
pagingModelOptionalExpand Search — projects search Projects — response body — paging
resultsarrayRequired within parentAn array of SimplePublicObject items, each representing a public object with its properties.
results[]ModelEach itemExpand Create — projects create Project — response body
totalJSONRequired within parent
total (anyOf 1)integerAlternativeThe number of available results
Format: int32
total (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Search — projects search Projects — response body — paging, Create — projects create Project — response body

Search — projects search Projects — response body — paging

FieldTypePresenceDescription and constraints
$objectRootRepresents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
nextModelOptionalExpand List — projects get Projects — response body — paging next
prevModelOptionalExpand Search — projects search Projects — response body — paging prev

Referenced models: Search — projects search Projects — response body — paging prev, List — projects get Projects — response body — paging next

Search — projects search Projects — response body — paging prev

FieldTypePresenceDescription and constraints
$objectRootspecifies the paging information needed to retrieve the previous set of results in a paginated API response
beforestringRequired within parentA string token used to identify the position before the current page in the pagination sequence.
linkstringOptionalA URL string that provides a direct link to the previous page of results.

Update batch objects — projects batch Update Projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input component used to handle multiple simple public objects in a single API request. This component is typically used when performing batch operations to create, update, or delete multiple records simultaneously.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInput items, each representing a single object to be updated. Each item includes the object's properties and optional metadata.
inputs[]ModelEach itemExpand Update batch objects — projects batch Update Projects — request body — body inputs item

Referenced models: Update batch objects — projects batch Update Projects — request body — body inputs item

Update batch objects — projects batch Update Projects — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootContains an array of CRM object records to be processed in a batch operation, each defined by their ID and properties.
idstringRequired within parentA string representing the unique identifier of the object.
idPropertystringOptionalA string indicating the name of a property whose values are unique for this object type.
objectWriteTraceIdstringOptionalA string that serves as a trace identifier for the object write operation.
propertiesobjectRequired within parentAn object containing key-value pairs where keys are property names and values are the corresponding property values. Each value is expected to be a string.
Additional keys: see wildcard field
properties.*stringAdditional keys

Update — projects update Project — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents the input required to update a CRM object, containing an object with property names and their corresponding values.
propertiesobjectRequired within parentAn object containing key-value pairs where each key is a property name and the value is the property's value. All properties are represented as strings.
Additional keys: see wildcard field
properties.*stringAdditional keys

Upsert batch objects — projects batch Upsert Projects — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input operation for upserting simple public objects in HubSpot. This component is used to process multiple upsert operations in a single request, improving efficiency and performance.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInputUpsert objects, each containing the properties and identifiers for a CRM object to be created or updated. This array is required.
inputs[]ModelEach itemExpand Upsert batch objects — projects batch Upsert Projects — request body — body inputs item

Referenced models: Upsert batch objects — projects batch Upsert Projects — request body — body inputs item

Upsert batch objects — projects batch Upsert Projects — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootRepresents an object used in batch upsert operations, containing an object’s unique identifier, its properties, and optionally the unique property name and a write trace ID.
idstringRequired within parentA string representing the unique identifier of the object to be upserted.
idPropertystringOptionalA string indicating the name of the property whose values are unique for this object type.
objectWriteTraceIdstringOptionalA string used to trace the write operation for debugging or logging purposes.
propertiesobjectRequired within parentAn object containing key-value pairs representing the properties of the CRM object. Each key is a property name, and the value is the property's value.
Additional keys: see wildcard field
properties.*stringAdditional keys

Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

FieldTypePresenceDescription and constraints
$objectRootRepresents a CRM object that has either been created or updated (upserted)
archivedbooleanRequired within parentA boolean indicating whether the object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
newbooleanRequired within parentA boolean indicating whether this object is newly created.
objectWriteTraceIdstringOptionalA string used to trace the write operations for this object.
propertiesobjectRequired within parentA map of property names to their values, where each property is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalAn object containing property names mapped to arrays of their historical values, each represented by a ValueWithTimestamp object.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — projects get Project — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalA string representing the URL of this object.
warningsarrayOptionalAn array of warnings related to this object, each represented by a PublicObjectWarning object.
warnings[]ModelEach itemExpand Read — projects get Project — response body — warnings item

Referenced models: Read — projects get Project — response body — warnings item, Read — projects get Project — response body — properties With History value item

Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Projects Batch Response Simple Public Upsert Object

FieldTypePresenceDescription and constraints
$objectRootRepresents the result of a batch upsert operation, including the operation’s status, timestamps, and a list of successfully created or updated objects.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
linksobjectOptionalA map of link names to associated URIs, providing additional context or actions related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of results from the batch upsert operation, each represented as a SimplePublicUpsertObject.
results[]ModelEach itemExpand Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Projects Batch Response Simple Public Upsert Object With Errors

FieldTypePresenceDescription and constraints
$objectRootRepresents the response from a batch upsert operation, including the status, timestamps, successfully processed objects, and any errors that occurred during processing.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
errorsarrayOptionalAn array of StandardError items detailing any errors that occurred during the batch operation.
errors[]ModelEach itemExpand Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
linksobjectOptionalA map of link names to associated URIs, providing additional information or actions related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
numErrorsJSONOptional
numErrors (anyOf 1)integerAlternativeThe total number of errors encountered during the batch operation.
Format: int32
numErrors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicUpsertObject items representing the results of the upsert operation.
results[]ModelEach itemExpand Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Upsert batch objects — projects.batchUpsertProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item, Batch read objects — projects.batchGetProjects — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.