--- title: "CloudObjectTemplates.batch_create_or_update" method: POST path: "/entities/CloudObjectTemplates/batch-modify" tags: ["Document"] --- # CloudObjectTemplates.batch_create_or_update `POST /entities/CloudObjectTemplates/batch-modify` ## Request - Base URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id` - URL: `https://us-east.api.coevera.com/api/v100/rest/spaces/your_space_id/entities/CloudObjectTemplates/batch-modify` - Auth: HTTP basic - TypeScript: (a function with typed inputs; its response is checked against the schema) Creates or updates CloudObjectTemplate records in one request: an item with an id updates that record, an item without one creates a new record. ## Query parameters - `validation-level` integer - `rollback-method` 0 | 1 ## Request body - BatchCloudObjectTemplateInput[] - `application_id` string, uuid: Id of the producing application. - `company_cloud_object_folder_id` string, uuid: Id of the company folder, or empty when the object is not stored in the company tree. - `creator_id` string, uuid: Id of the uploading user. - `filename` string: File name (with extension) used when downloading the object. - `is_public` boolean: When true, the object can be served via a public URL (see public_url). - `status` 1 | 2: Whether the document template is active and offered for generating documents, or inactive and kept for later use. Defaults to Active. Integer enum value: 1 - Active, 2 - Inactive - `template_entity_name` 'Account' | 'AccountDataExRelation' | 'AccountKPI' | 'AccountProductPricing' | 'AccountRole' | 'AccountSharingClientRelation' | 'AccountSharingSalesUnitRelation' | 'AccountSocialRelation' | 'AccountType' | 'Activity' | 'ActivityComment' | 'ActivityDataExRelation' | 'ActivityDetail' | 'ActivityKPI' | 'ActivityRelation' | 'ActivityType' | 'AiAgent' | 'AiBalance' | 'AiEvent' | 'AiEventJournal' | 'AllowedAccountType' | 'AllowedAppointmentType' | 'AllowedCompanyPhone' | 'AllowedContactType' | 'AllowedLeadType' | 'AllowedPipeline' | 'AllowedQuoteType' | 'AllowedTaskType' | 'ApiAccess' | 'Application' | 'Appointment' | 'AppointmentClientInviteesRelation' | 'AppointmentContactInviteesRelation' | 'AppointmentInviteeNotifyQueue' | 'AppointmentReminder' | 'AppointmentSchedule' | 'AppointmentType' | 'Approval' | 'ApprovalApprover' | 'ApprovalProcess' | 'ApprovalProcessActivityLogLine' | 'AuditLog' | 'AutomationHubApp' | 'AutomationHubCategory' | 'AutomationHubItem' | 'ChatConversation' | 'Client' | 'ClientExcludedOppty' | 'ClientFavorite' | 'ClientSetting' | 'ClientStoryRead' | 'CloudObject' | 'CloudObjectFolder' | 'CloudObjectRelation' | 'CloudObjectStepRelation' | 'CloudObjectTemplate' | 'CompanyEmail' | 'Contact' | 'ContactAccountAccountRoleRelation' | 'ContactAccountRelation' | 'ContactDataExRelation' | 'ContactKPI' | 'ContactRelation' | 'ContactRelationType' | 'ContactSharingClientRelation' | 'ContactSharingSalesUnitRelation' | 'ContactSocialRelation' | 'ContactType' | 'Country' | 'CountryCrm' | 'CpActivity' | 'CpCallLog' | 'CpCalling' | 'CpClient' | 'CpProduct' | 'CpProfile' | 'CpTeamSpaceClient' | 'Currency' | 'CurrencyExchangeRate' | 'CurrencyExchangeRatesList' | 'CustomEntity' | 'CustomEntityDataExRelation' | 'CustomEntityKPI' | 'CustomEntityRelation' | 'CustomEntityRelationData' | 'CustomEntitySharingClientRelation' | 'CustomEntitySharingSalesUnitRelation' | 'CustomEntityType' | 'Data' | 'Ebook' | 'Email' | 'EmailContentSharingClientRelation' | 'EmailContentSharingSalesUnitRelation' | 'EmailLabel' | 'EmailLabelRelation' | 'EmailMailboxRelation' | 'EmailSequence' | 'EmailSequenceActivityLog' | 'EmailSequenceActivityLogLine' | 'EmailSequenceEnrolled' | 'EmailSequenceEnrolledStatus' | 'EmailSequenceSettings' | 'EmailTemplate' | 'EmailTemplateFolder' | 'EmailTemplateSharingClientRelation' | 'EmailTemplateSharingSalesUnitRelation' | 'EmailThreadMailboxClientReadState' | 'Entity' | 'EntityFitness' | 'EntityFitnessIndicator' | 'EntityHealth' | 'EntityHealthSettingsHistory' | 'EntityScoring' | 'EntitySettings' | 'EntityType' | 'Field' | 'FieldMapping' | 'FieldPermission' | 'FieldSequence' | 'Forecast' | 'ForecastSharingClientRelation' | 'ForecastSharingSalesUnitRelation' | 'FormView' | 'FormViewSharingClientRelation' | 'FormViewSharingSalesUnitRelation' | 'GhostContact' | 'GhostContactAccountAccountRoleRelation' | 'GhostContactAccountRelation' | 'GhostLeadOpptyContactRelation' | 'GhostLeadOpptyContactSalesRoleRelation' | 'HowTo' | 'ImportMappingMask' | 'InterfacePreview' | 'Lead' | 'LeadOppty' | 'LeadOpptyAccountRelation' | 'LeadOpptyContactGroupRelation' | 'LeadOpptyContactRelation' | 'LeadOpptyContactSalesRoleRelation' | 'LeadOpptyDataExRelation' | 'LeadOpptyKPI' | 'LeadOpptyProjectRelation' | 'LeadOpptySharingClientRelation' | 'LeadOpptySharingSalesUnitRelation' | 'LeadOpptyStepCheckListRelation' | 'LeadOpptyType' | 'LeadProcess' | 'LeadType' | 'MasterRight' | 'Media' | 'Memo' | 'MemoComment' | 'Message' | 'MessageRelation' | 'MessageSharingClientRelation' | 'MessageSharingSalesUnitRelation' | 'Note' | 'NotificationSetting' | 'OnlineForm' | 'OnlineFormActivityLogLine' | 'OnlineFormDataExRelation' | 'OnlineFormRelation' | 'OnlineFormStyle' | 'OnlineFormType' | 'OnlineFormTypeEmailRelation' | 'Opportunity' | 'OpportunityType' | 'OpptyProductRelation' | 'OpptyProductRelationDataExRelation' | 'OpptyProductRelationRevenueSchedule' | 'OpptyProductRelationRevenueSchedulePeriod' | 'OpptyProductRelationType' | 'OpptyRecurrence' | 'OpptyRevenueSchedule' | 'OpptyRevenueSchedulePeriod' | 'Order' | 'OrderHistory' | 'OrderItem' | 'OrderRelatedDocument' | 'OrderTempData' | 'OrderTempDataItem' | 'ParentAccountRelationType' | 'Partner' | 'Payment' | 'PaymentAdditionalData' | 'PaymentTerm' | 'Phone' | 'Pipeline' | 'Process' | 'ProcessActivityLog' | 'ProcessActivityLogLine' | 'ProcessChangeOwnerLog' | 'ProcessScheduledAction' | 'ProcessTemplate' | 'Product' | 'ProductCategory' | 'ProductDataExRelation' | 'ProductPipelineRelation' | 'ProductPriceList' | 'ProductPriceListPrice' | 'ProductType' | 'Profile' | 'ProfileDraft' | 'ProfileRelation' | 'ProfileSharingClientRelation' | 'ProfileSharingSalesUnitRelation' | 'Project' | 'ProjectContactRelation' | 'ProjectDataExRelation' | 'ProjectKPI' | 'ProjectObjective' | 'ProjectSharingClientRelation' | 'ProjectSharingSalesUnitRelation' | 'ProjectType' | 'PurchasedProduct' | 'Quote' | 'QuoteAccountRelation' | 'QuoteContactRelation' | 'QuoteDataExRelation' | 'QuoteKPI' | 'QuoteProcess' | 'QuoteSharingClientRelation' | 'QuoteSharingSalesUnitRelation' | 'QuoteType' | 'ReleaseNote' | 'Report' | 'ReportFolder' | 'ReportSchedule' | 'ReportSharingClientRelation' | 'ReportSharingSalesUnitRelation' | 'RevenueRecognition' | 'SalesRole' | 'SalesUnit' | 'SalesUnitClientRelation' | 'SapiUser' | 'Solution' | 'SolutionTemplate' | 'SpaceSetting' | 'State' | 'Step' | 'StepChecklist' | 'StepChecklistSalesRoleRelation' | 'Storylane' | 'Subscription' | 'SubscriptionHubItem' | 'SubscriptionNotification' | 'SubscriptionRepresentative' | 'SubscriptionSDR' | 'Supplier' | 'Tag' | 'TagRelation' | 'Target' | 'TargetRelation' | 'Task' | 'TaskRecurrence' | 'TaskReminder' | 'TaskSharingClientRelation' | 'TaskSharingSalesUnitRelation' | 'TaskType' | 'TeamPipelineHubItem' | 'TeamPipelineHubItemBase' | 'TeamSpace' | 'TeamSpaceClient' | 'TeamSpaceClientSetting' | 'TeamSpaceProperty' | 'TeamSpaceRegion' | 'TextMessage' | 'TextMessageConversation' | 'TextMessageConversationRelations' | 'Timeframe' | 'Translation' | 'Type' | 'UnsubscribedPhone' | 'UseCase' | 'UserProfile' | 'UserRole' | 'Webhook' | 'WebhookEvent' | 'Webresource': Entity type the template renders (e.g. Account, Opportunity, Quote). For custom entities, the value is "CustomEntity" and the API name is exposed via template_entity_api_name. - `upload_source` 1 | 2: Editor the uploaded image is embedded in, such as an email template or rich-text content. Empty for files that are not embedded images. Integer enum value: 1 - EmailTemplate, 2 - RichTextEditor - `revision` integer: Revision when entity was lastly changed. - `content` string, binary: Data content of the object. - `template_entity_api_name` string: API name of the custom entity the template renders. Set only when template_entity_name is "CustomEntity"; otherwise empty. - `id` string, uuid: ID of object to update. ## Response `200` Result per item, in request order: the id of the created or updated record, or the error. - object - `success` boolean: True when the request succeeded; false on error. - `data` union[] - union - string, uuid: Id of the created or updated record. - Error: The body of every REST error. `code` and `name` are stable identifiers; `message` is for people. The full list of codes is at https://developers.coevera.com/reference/errors/. - `http_status` integer, required: HTTP status code. - `code` integer: Numeric code of the API error. - `name` string: Name of the API error. - `message` string: Message describing the error. - `success` boolean, required: Always false on error. ## Other responses - `400`: Bad request: a bad or unknown parameter (codes 117, 118), a missing permission (code 50), conflicting data (code 2002) or any other API error. The REST API answers 400 where others answer 403 or 409; check `code`. - `401`: Not authenticated: missing or wrong credentials, a credential of another space, or an expired token (code 401, ERROR_UNAUTHORIZED). - `422`: Validation failed (code 40000, with the failing fields) or a required parameter is missing (code 119). By default one failed item fails a whole batch and nothing is written. - `429`: Too many requests (code 182). Wait for the seconds in Retry-After, then retry. - `500`: Unexpected server error (code 1000, ERROR_UNKNOWN). --- [API](https://skmtc.dev/coevera/apis/coevera-crm-api.md) - [All operations](https://skmtc.dev/coevera/apis/coevera-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coevera/apis/coevera-crm-api/revisions/40ebbc83f179?raw)