Tag

Tags are free key-value pair metadata which can be associated with media in order to categorise and perform lookups against integration API endpoints.

Create (or update) Tag

Create or update a Tag on the requested Media

PUThttps://api.orb360.tech/api/tenant/{tenantId}/shoot/{shootId}/media/{mediaId}/tags

Authorization

bearerapi_key

Path parameters

shootId*string

Unique shoot id

Example: "683606ee-9788-4d88-adb8-77119de4c6a2"

tenantId*string

Unique tenant id

Example: "f700d27e-64ed-4571-ae2e-8c948c1c296e"

mediaId*string

Unique media id

Example: "daea0774-275b-4e43-9d10-c2f9d5d4d5b6"

Body

application/json

tagsarray

Tag key-pairs to be created/replaced for the specified media

Response

200400401404

success

Body

application/json

tagsobject

All tags for the requested media, including changes made by this request

Request

JavaScriptCurlPython

const response = await fetch('https://api.orb360.tech/api/tenant/{tenantId}/shoot/{shootId}/media/{mediaId}/tags', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401404

{}

Delete Tag

Delete a Tag from it's associated Media

DELETEhttps://api.orb360.tech/api/tenant/{tenantId}/shoot/{shootId}/media/{mediaId}/tags

Authorization

bearerapi_key

Path parameters

shootId*string

Unique shoot id

Example: "683606ee-9788-4d88-adb8-77119de4c6a2"

tenantId*string

Unique tenant id

Example: "f700d27e-64ed-4571-ae2e-8c948c1c296e"

mediaId*string

Unique media id

Example: "daea0774-275b-4e43-9d10-c2f9d5d4d5b6"

Body

application/json

tagsarray

Tag key-pairs to be removed from the specified media

Response

200400401404

success

Body

application/json

tagsobject

All tags for the requested media, including changes made by this request

Request

JavaScriptCurlPython

const response = await fetch('https://api.orb360.tech/api/tenant/{tenantId}/shoot/{shootId}/media/{mediaId}/tags', {
    method: 'DELETE',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401404

{}