MediaSet

Method	HTTP request	Release Stage
abort	POST /v2/mediasets/{mediaSetRid}/transactions/{transactionId}/abort	Public Beta
commit	POST /v2/mediasets/{mediaSetRid}/transactions/{transactionId}/commit	Public Beta
create	POST /v2/mediasets/{mediaSetRid}/transactions	Public Beta
info	GET /v2/mediasets/{mediaSetRid}/items/{mediaItemRid}	Public Beta
read	GET /v2/mediasets/{mediaSetRid}/items/{mediaItemRid}/content	Public Beta
reference	GET /v2/mediasets/{mediaSetRid}/items/{mediaItemRid}/reference	Public Beta
upload	POST /v2/mediasets/{mediaSetRid}/items	Public Beta

abort

Aborts an open transaction. Items uploaded to the media set during this transaction will be deleted.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-write.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
transaction_id	TransactionId	transactionId
preview	Optional[PreviewMode]	preview	[optional]

Return type

None

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# TransactionId | transactionId
transaction_id = None
# Optional[PreviewMode] | preview
preview = None


try:
    api_response = foundry_client.media_sets.MediaSet.abort(
        media_set_rid,
        transaction_id,
        preview=preview,
    )
    print("The abort response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.abort: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
204	None		None

[Back to top] [Back to API list] [Back to Model list] [Back to README]

commit

Commits an open transaction. On success, items uploaded to the media set during this transaction will become available.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-write.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
transaction_id	TransactionId	transactionId
preview	Optional[PreviewMode]	preview	[optional]

Return type

None

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# TransactionId | transactionId
transaction_id = None
# Optional[PreviewMode] | preview
preview = None


try:
    api_response = foundry_client.media_sets.MediaSet.commit(
        media_set_rid,
        transaction_id,
        preview=preview,
    )
    print("The commit response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.commit: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
204	None		None

[Back to top] [Back to API list] [Back to Model list] [Back to README]

create

Creates a new transaction. Items uploaded to the media set while this transaction is open will not be reflected until the transaction is committed.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-write.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
branch_name	Optional[BranchName]	branchName	[optional]
preview	Optional[PreviewMode]	preview	[optional]

Return type

TransactionId

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# Optional[BranchName] | branchName
branch_name = None
# Optional[PreviewMode] | preview
preview = None


try:
    api_response = foundry_client.media_sets.MediaSet.create(
        media_set_rid,
        branch_name=branch_name,
        preview=preview,
    )
    print("The create response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.create: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
200	TransactionId		application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

info

Gets information about the media item.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-read.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
media_item_rid	MediaItemRid	mediaItemRid
preview	Optional[PreviewMode]	preview	[optional]
read_token	Optional[MediaItemReadToken]	ReadToken	[optional]

Return type

GetMediaItemInfoResponse

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# MediaItemRid | mediaItemRid
media_item_rid = None
# Optional[PreviewMode] | preview
preview = None
# Optional[MediaItemReadToken] | ReadToken
read_token = None


try:
    api_response = foundry_client.media_sets.MediaSet.info(
        media_set_rid,
        media_item_rid,
        preview=preview,
        read_token=read_token,
    )
    print("The info response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.info: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
200	GetMediaItemInfoResponse		application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

read

Gets the content of a media item.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-read.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
media_item_rid	MediaItemRid	mediaItemRid
preview	Optional[PreviewMode]	preview	[optional]
read_token	Optional[MediaItemReadToken]	ReadToken	[optional]

Return type

bytes

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# MediaItemRid | mediaItemRid
media_item_rid = None
# Optional[PreviewMode] | preview
preview = None
# Optional[MediaItemReadToken] | ReadToken
read_token = None


try:
    api_response = foundry_client.media_sets.MediaSet.read(
        media_set_rid,
        media_item_rid,
        preview=preview,
        read_token=read_token,
    )
    print("The read response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.read: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
200	bytes	The content stream.	/

[Back to top] [Back to API list] [Back to Model list] [Back to README]

reference

Gets the media reference for this media item.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-read.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
media_item_rid	MediaItemRid	mediaItemRid
preview	Optional[PreviewMode]	preview	[optional]
read_token	Optional[MediaItemReadToken]	ReadToken	[optional]

Return type

MediaReference

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# MediaItemRid | mediaItemRid
media_item_rid = None
# Optional[PreviewMode] | preview
preview = None
# Optional[MediaItemReadToken] | ReadToken
read_token = None


try:
    api_response = foundry_client.media_sets.MediaSet.reference(
        media_set_rid,
        media_item_rid,
        preview=preview,
        read_token=read_token,
    )
    print("The reference response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.reference: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
200	MediaReference		application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

upload

Uploads a media item to an existing media set. The body of the request must contain the binary content of the file and the Content-Type header must be application/octet-stream. A branch name, or branch rid, or view rid may optionally be specified. If none is specified, the item will be uploaded to the default branch. If more than one is specified, an error is thrown.

Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:mediasets-write.

Parameters

Name	Type	Description	Notes
media_set_rid	MediaSetRid	mediaSetRid
body	bytes	Body of the request
branch_name	Optional[BranchName]	branchName	[optional]
branch_rid	Optional[BranchRid]	branchRid	[optional]
media_item_path	Optional[MediaItemPath]	mediaItemPath	[optional]
preview	Optional[PreviewMode]	preview	[optional]
transaction_id	Optional[TransactionId]	transactionId	[optional]
view_rid	Optional[MediaSetViewRid]	viewRid	[optional]

Return type

PutMediaItemResponse

Example

from foundry.v2 import FoundryClient
import foundry
from pprint import pprint

foundry_client = FoundryClient(
    auth=foundry.UserTokenAuth(...), hostname="example.palantirfoundry.com"
)

# MediaSetRid | mediaSetRid
media_set_rid = None
# bytes | Body of the request
body = None
# Optional[BranchName] | branchName
branch_name = None
# Optional[BranchRid] | branchRid
branch_rid = None
# Optional[MediaItemPath] | mediaItemPath
media_item_path = "q3-data%2fmy-file.png"
# Optional[PreviewMode] | preview
preview = None
# Optional[TransactionId] | transactionId
transaction_id = None
# Optional[MediaSetViewRid] | viewRid
view_rid = None


try:
    api_response = foundry_client.media_sets.MediaSet.upload(
        media_set_rid,
        body,
        branch_name=branch_name,
        branch_rid=branch_rid,
        media_item_path=media_item_path,
        preview=preview,
        transaction_id=transaction_id,
        view_rid=view_rid,
    )
    print("The upload response:\n")
    pprint(api_response)
except foundry.PalantirRPCException as e:
    print("HTTP error when calling MediaSet.upload: %s\n" % e)

Authorization

See README

HTTP response details

Status Code	Type	Description	Content Type
200	PutMediaItemResponse		application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

Files

MediaSet.md

Latest commit

History

MediaSet.md

File metadata and controls

MediaSet

abort

Parameters

Return type

Example

Authorization

HTTP response details

commit

Parameters

Return type

Example

Authorization

HTTP response details

create

Parameters

Return type

Example

Authorization

HTTP response details

info

Parameters

Return type

Example

Authorization

HTTP response details

read

Parameters

Return type

Example

Authorization

HTTP response details

reference

Parameters

Return type

Example

Authorization

HTTP response details

upload

Parameters

Return type

Example

Authorization

HTTP response details