MetadataTemplatesManager

• Find metadata template by instance ID
• Get metadata template by name
• Update metadata template
• Remove metadata template
• Get metadata template by ID
• List all global metadata templates
• List all metadata templates for enterprise
• Create metadata template

Find metadata template by instance ID

Finds a metadata template by searching for the ID of an instance of the template.

This operation is performed by calling function getMetadataTemplatesByInstanceId.

See the endpoint docs at API Reference.

try await client.metadataTemplates.getMetadataTemplatesByInstanceId(queryParams: GetMetadataTemplatesByInstanceIdQueryParams(metadataInstanceId: createdMetadataInstance.id!))

Arguments

• queryParams GetMetadataTemplatesByInstanceIdQueryParams
  • Query parameters of getMetadataTemplatesByInstanceId method
• headers GetMetadataTemplatesByInstanceIdHeaders
  • Headers of getMetadataTemplatesByInstanceId method

Returns

This function returns a value of type MetadataTemplates.

Returns a list containing the 1 metadata template that matches the instance ID.

Get metadata template by name

Retrieves a metadata template by its scope and templateKey values.

To find the scope and templateKey for a template, list all templates for an enterprise or globally, or list all templates applied to a file or folder.

This operation is performed by calling function getMetadataTemplate.

See the endpoint docs at API Reference.

try await client.metadataTemplates.getMetadataTemplate(scope: GetMetadataTemplateScope.enterprise, templateKey: template.templateKey!)

Arguments

• scope GetMetadataTemplateScope
  • The scope of the metadata template. Example: "global"
• templateKey String
  • The name of the metadata template. Example: "properties"
• headers GetMetadataTemplateHeaders
  • Headers of getMetadataTemplate method

Returns

This function returns a value of type MetadataTemplate.

Returns the metadata template matching the scope and template name.

Update metadata template

Updates a metadata template.

The metadata template can only be updated if the template already exists.

The update is applied atomically. If any errors occur during the application of the operations, the metadata template will not be changed.

This operation is performed by calling function updateMetadataTemplate.

See the endpoint docs at API Reference.

try await client.metadataTemplates.updateMetadataTemplate(scope: UpdateMetadataTemplateScope.enterprise, templateKey: templateKey, requestBody: [UpdateMetadataTemplateRequestBody(op: UpdateMetadataTemplateRequestBodyOpField.addField, fieldKey: "newfieldname", data: ["type": "string", "displayName": "newFieldName"])])

Arguments

• scope UpdateMetadataTemplateScope
  • The scope of the metadata template. Example: "global"
• templateKey String
  • The name of the metadata template. Example: "properties"
• requestBody [UpdateMetadataTemplateRequestBody]
  • Request body of updateMetadataTemplate method
• headers UpdateMetadataTemplateHeaders
  • Headers of updateMetadataTemplate method

Returns

This function returns a value of type MetadataTemplate.

Returns the updated metadata template, with the custom template data included.

Remove metadata template

Delete a metadata template and its instances. This deletion is permanent and can not be reversed.

This operation is performed by calling function deleteMetadataTemplate.

See the endpoint docs at API Reference.

try await client.metadataTemplates.deleteMetadataTemplate(scope: DeleteMetadataTemplateScope.enterprise, templateKey: template.templateKey!)

Arguments

• scope DeleteMetadataTemplateScope
  • The scope of the metadata template. Example: "global"
• templateKey String
  • The name of the metadata template. Example: "properties"
• headers DeleteMetadataTemplateHeaders
  • Headers of deleteMetadataTemplate method

Returns

This function returns a value of type ``.

Returns an empty response when the metadata template is successfully deleted.

Get metadata template by ID

Retrieves a metadata template by its ID.

This operation is performed by calling function getMetadataTemplateById.

See the endpoint docs at API Reference.

try await client.metadataTemplates.getMetadataTemplateById(templateId: template.id)

Arguments

• templateId String
  • The ID of the template. Example: "f7a9891f"
• headers GetMetadataTemplateByIdHeaders
  • Headers of getMetadataTemplateById method

Returns

This function returns a value of type MetadataTemplate.

Returns the metadata template that matches the ID.

List all global metadata templates

Used to retrieve all generic, global metadata templates available to all enterprises using Box.

This operation is performed by calling function getGlobalMetadataTemplates.

See the endpoint docs at API Reference.

try await client.metadataTemplates.getGlobalMetadataTemplates()

Arguments

• queryParams GetGlobalMetadataTemplatesQueryParams
  • Query parameters of getGlobalMetadataTemplates method
• headers GetGlobalMetadataTemplatesHeaders
  • Headers of getGlobalMetadataTemplates method

Returns

This function returns a value of type MetadataTemplates.

Returns all of the metadata templates available to all enterprises and their corresponding schema.

List all metadata templates for enterprise

Used to retrieve all metadata templates created to be used specifically within the user's enterprise.

This operation is performed by calling function getEnterpriseMetadataTemplates.

See the endpoint docs at API Reference.

try await client.metadataTemplates.getEnterpriseMetadataTemplates()

Arguments

• queryParams GetEnterpriseMetadataTemplatesQueryParams
  • Query parameters of getEnterpriseMetadataTemplates method
• headers GetEnterpriseMetadataTemplatesHeaders
  • Headers of getEnterpriseMetadataTemplates method

Returns

This function returns a value of type MetadataTemplates.

Returns all of the metadata templates within an enterprise and their corresponding schema.

Create metadata template

Creates a new metadata template that can be applied to files and folders.

This operation is performed by calling function createMetadataTemplate.

See the endpoint docs at API Reference.

try await client.metadataTemplates.createMetadataTemplate(requestBody: CreateMetadataTemplateRequestBody(scope: "enterprise", displayName: templateKey, templateKey: templateKey, fields: [CreateMetadataTemplateRequestBodyFieldsField(type: CreateMetadataTemplateRequestBodyFieldsTypeField.string, key: "testName", displayName: "testName"), CreateMetadataTemplateRequestBodyFieldsField(type: CreateMetadataTemplateRequestBodyFieldsTypeField.float, key: "age", displayName: "age"), CreateMetadataTemplateRequestBodyFieldsField(type: CreateMetadataTemplateRequestBodyFieldsTypeField.date, key: "birthDate", displayName: "birthDate"), CreateMetadataTemplateRequestBodyFieldsField(type: CreateMetadataTemplateRequestBodyFieldsTypeField.enum_, key: "countryCode", displayName: "countryCode", options: [CreateMetadataTemplateRequestBodyFieldsOptionsField(key: "US"), CreateMetadataTemplateRequestBodyFieldsOptionsField(key: "CA")]), CreateMetadataTemplateRequestBodyFieldsField(type: CreateMetadataTemplateRequestBodyFieldsTypeField.multiSelect, key: "sports", displayName: "sports", options: [CreateMetadataTemplateRequestBodyFieldsOptionsField(key: "basketball"), CreateMetadataTemplateRequestBodyFieldsOptionsField(key: "football"), CreateMetadataTemplateRequestBodyFieldsOptionsField(key: "tennis")])]))

Arguments

• requestBody CreateMetadataTemplateRequestBody
  • Request body of createMetadataTemplate method
• headers CreateMetadataTemplateHeaders
  • Headers of createMetadataTemplate method

Returns

This function returns a value of type MetadataTemplate.

The schema representing the metadata template created.