Get file access information

post https://app.mk.io/api/v1/projects/:project_name/media/assets/:asset_name/getFileAccessInfo

This endpoint returns the information needed to access files within your asset.

The storage account containing the asset must be configured with a valid SAS token.

The response includes

• storageAccountName: the storage account name,
• containerName: the name of the container within the storage account,
• jwt: a token to be passed along with your request,
• url: the URL to access the container.
• subpath: the subpath to the location of the asset within the container.

Please see our online documentation for examples of how to use these.

RBAC Capability Required: ams.asset.create or ams.asset.update

Authentication

Authorization Bearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

• project_namestring Required
• asset_namestring Required

Response

200 Access Information

• containerNamestring Required: The name of the container within the storage account.
• jwtstring Required: A JWT token to authenticate the request.
• storageAccountNamestring Required: The name of the storage account.
• subPathstring Optional 0-256 characters: Optional subpath for instances where your asset is not in the root of the container.
• urlstring Required: The URL to use to access the container.

Errors

400 Bad Request

• errorobject [ErrorDetail](https://docs.mediakind.com/api-reference/media-api/schemas/errordetail) Required
  • codestring Required: The error code.
  • detailstring Required: The error message.
  • extraDetailmap from strings to any Optional: Extra information regarding this error.
  • refstring Required: A reference to the request that caused the error.
  • statusinteger Required: The HTTP status code

401 Unauthorized

(Details similar to 400)

403 Forbidden

(Details similar to 400)

404 Not Found

(Details similar to 400)

429 Too Many Requests

(Details similar to 400)

500 Internal Server Error

(Details similar to 400)