api.clarify.io
  1. bundles
api.clarify.io
  • bundles
    • List bundles
      GET
    • Create a bundle
      POST
    • Delete a bundle
      DELETE
    • Get a bundle
      GET
    • Update a bundle
      PUT
    • Get bundle insights
      GET
    • Request an insight to be run
      POST
    • Get bundle insight
      GET
    • Delete bundle metadata
      DELETE
    • Get bundle metadata
      GET
    • Update bundle metadata
      PUT
    • Delete bundle tracks
      DELETE
    • Get bundle tracks
      GET
    • Add a track for a bundle
      POST
    • Update a tracks for a bundle
      PUT
    • Delete a bundle track
      DELETE
    • Get bundle track
      GET
    • Add media to a track
      PUT
  • reports
    • Generate Group Report <span class="label">beta</span>
      GET
    • Generate Trends Report <span class="label">beta</span>
      GET
  • search
    • Search bundles
      GET
  1. bundles

Update bundle metadata

PUT
/v1/bundles/{bundle_id}/metadata
Update the metadata for a bundle.

The metadata is a single-level JSON object of your own definition, containing key-values that can be searched and filtered on. Metadata can be used to hold text such as names, titles, descriptions and values for segregating bundles, for example by user, topic, folder name etc. The keys (property names) can be up to 64 characters and must contain only alphanumeric characters and underscore (but not start with underscore) and must not be a reserved name. Reserved names are "true", "false", and "null". Values can be strings, numbers, boolean true/false, date-times represented as a string in ISO 8601 format (ex. "2014-02-25T14:23:45.000Z"), or an array of these primitive types. Strings can be up to 2000 characters and strings in arrays can be up to 128 characters each. Nested objects are not allowed. Metadata can contain up to 50 key-value pairs up to a total JSON size of 4000 characters.

To clear the metadata for a bundle, send data={}.

If version specified, the metadata will only be updated if the current version matches this parameter value. If the version doesn't match, a 409 Conflict will be returned. If version not specified, the metadata will always be updated.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.clarify.io//v1/bundles//metadata' \
--data-urlencode 'data='
Response Response Example
200 - Example 1
{}

Request

Path Params
bundle_id
string 
required
id of a bundle
Body Params application/x-www-form-urlencoded
data
string 
required
User-defined JSON data associated with the bundle. Must be valid JSON, up to 4000 characters.
version
string 
optional
Object version.

Responses

🟢200No response was specified
application/json
Body
object {0}
🟢202Accepted
🟠400Bad request
🟠404Not found
🟠409Conflict
Modified at 2022-09-10 16:56:00
Previous
Get bundle metadata
Next
Delete bundle tracks
Built with