Skip to content

skills.md

Latest commit

 

History

History
164 lines (100 loc) · 5.53 KB

skills.md

File metadata and controls

164 lines (100 loc) · 5.53 KB

SkillsManager

List Box Skill cards on file

List the Box Skills metadata cards that are attached to a file.

This operation is performed by calling function getBoxSkillCardsOnFile.

See the endpoint docs at API Reference.

client.getSkills().getBoxSkillCardsOnFile(file.getId())

Arguments

  • fileId String
    • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
  • headers GetBoxSkillCardsOnFileHeaders
    • Headers of getBoxSkillCardsOnFile method

Returns

This function returns a value of type SkillCardsMetadata.

Returns all the metadata associated with a file.

This API does not support pagination and will therefore always return all of the metadata associated to the file.

Create Box Skill cards on file

Applies one or more Box Skills metadata cards to a file.

This operation is performed by calling function createBoxSkillCardsOnFile.

See the endpoint docs at API Reference.

client.getSkills().createBoxSkillCardsOnFile(file.getId(), new CreateBoxSkillCardsOnFileRequestBody(cardsToCreate))

Arguments

  • fileId String
    • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
  • requestBody CreateBoxSkillCardsOnFileRequestBody
    • Request body of createBoxSkillCardsOnFile method
  • headers CreateBoxSkillCardsOnFileHeaders
    • Headers of createBoxSkillCardsOnFile method

Returns

This function returns a value of type SkillCardsMetadata.

Returns the instance of the template that was applied to the file, including the data that was applied to the template.

Update Box Skill cards on file

Updates one or more Box Skills metadata cards to a file.

This operation is performed by calling function updateBoxSkillCardsOnFile.

See the endpoint docs at API Reference.

client.getSkills().updateBoxSkillCardsOnFile(file.getId(), Arrays.asList(new UpdateBoxSkillCardsOnFileRequestBody.Builder().op(UpdateBoxSkillCardsOnFileRequestBodyOpField.REPLACE).path("/cards/0").value(cardToUpdate).build()))

Arguments

  • fileId String
    • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
  • requestBody List<UpdateBoxSkillCardsOnFileRequestBody>
    • Request body of updateBoxSkillCardsOnFile method
  • headers UpdateBoxSkillCardsOnFileHeaders
    • Headers of updateBoxSkillCardsOnFile method

Returns

This function returns a value of type SkillCardsMetadata.

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

Remove Box Skill cards from file

Removes any Box Skills cards metadata from a file.

This operation is performed by calling function deleteBoxSkillCardsFromFile.

See the endpoint docs at API Reference.

client.getSkills().deleteBoxSkillCardsFromFile(file.getId())

Arguments

  • fileId String
    • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
  • headers DeleteBoxSkillCardsFromFileHeaders
    • Headers of deleteBoxSkillCardsFromFile method

Returns

This function returns a value of type void.

Returns an empty response when the cards are successfully deleted.

Update all Box Skill cards on file

An alternative method that can be used to overwrite and update all Box Skill metadata cards on a file.

This operation is performed by calling function updateAllSkillCardsOnFile.

See the endpoint docs at API Reference.

Currently we don't have an example for calling updateAllSkillCardsOnFile in integration tests

Arguments

  • skillId String
    • The ID of the skill to apply this metadata for. Example: "33243242"
  • requestBody UpdateAllSkillCardsOnFileRequestBody
    • Request body of updateAllSkillCardsOnFile method
  • headers UpdateAllSkillCardsOnFileHeaders
    • Headers of updateAllSkillCardsOnFile method

Returns

This function returns a value of type void.

Returns an empty response when the card has been successfully updated.