Provider File

View as Markdown

Get a fileGET /api/2.0/marketplace-provider/files/{file_id}List filesGET /api/2.0/marketplace-provider/filesCreate a filePOST /api/2.0/marketplace-provider/filesDelete a fileDELETE /api/2.0/marketplace-provider/files/{file_id}

FileInfo object

idstringPublic Preview

marketplace_file_typestringPublic Preview

Values:

• PROVIDER_ICON
• EMBEDDED_NOTEBOOK
• APP

file_parentobjectPublic Preview

Show child attributesHide child attributes

parent_idstringPublic Preview

file_parent_typestringPublic Preview

Values:

• PROVIDER
• LISTING
• LISTING_RESOURCE

mime_typestringPublic Preview

download_linkstringPublic Preview

created_atint64Public Preview

updated_atint64Public Preview

display_namestringPublic Preview

Name displayed to users for applicable files, e.g. embedded notebooks

statusstringPublic Preview

Values:

• FILE_STATUS_PUBLISHED
• FILE_STATUS_STAGING
• FILE_STATUS_SANITIZING
• FILE_STATUS_SANITIZATION_FAILED

status_messagestringPublic Preview

Populated if status is in a failed state with more information on reason for the failure.

View as Markdown

The FileInfo object

{
  "id": "string",
  "marketplace_file_type": "PROVIDER_ICON",
  "file_parent": {
    "parent_id": "string",
    "file_parent_type": "PROVIDER"
  },
  "mime_type": "string",
  "download_link": "string",
  "created_at": 0,
  "updated_at": 0,
  "display_name": "string",
  "status": "FILE_STATUS_PUBLISHED",
  "status_message": "string"
}

Get a file Public Preview

GET /api/2.0/marketplace-provider/files/{file_id}

Get a file

API scopes: marketplace

Parameters

file_idstringRequiredpath

Response

file_infoobject

Show child attributesHide child attributes

idstring

marketplace_file_typestring

Values:

• PROVIDER_ICON
• EMBEDDED_NOTEBOOK
• APP

file_parentobject

Show child attributesHide child attributes

parent_idstring

file_parent_typestring

Values:

• PROVIDER
• LISTING
• LISTING_RESOURCE

mime_typestring

download_linkstring

created_atint64

updated_atint64

display_namestring

Name displayed to users for applicable files, e.g. embedded notebooks

statusstring

Values:

• FILE_STATUS_PUBLISHED
• FILE_STATUS_STAGING
• FILE_STATUS_SANITIZING
• FILE_STATUS_SANITIZATION_FAILED

status_messagestring

Populated if status is in a failed state with more information on reason for the failure.

View as Markdown

Response

{
  "file_info": {
    "id": "string",
    "marketplace_file_type": "PROVIDER_ICON",
    "file_parent": {},
    "mime_type": "string",
    "download_link": "string",
    "created_at": 0,
    "updated_at": 0,
    "display_name": "string",
    "status": "FILE_STATUS_PUBLISHED",
    "status_message": "string"
  }
}

List files Public Preview

GET /api/2.0/marketplace-provider/files

List files attached to a parent entity.

API scopes: marketplace

Parameters

file_parentobjectRequiredquery

Show child attributesHide child attributes

parent_idstring

file_parent_typestring

Values:

• PROVIDER
• LISTING
• LISTING_RESOURCE

page_tokenstringquery

page_sizeint32query

Response

Returns a list of FileInfo objects.

View as Markdown

Response

{
  "file_infos": [
    {
      "id": "string",
      "marketplace_file_type": "PROVIDER_ICON",
      "file_parent": {},
      "mime_type": "string",
      "download_link": "string",
      "created_at": 0,
      "updated_at": 0,
      "display_name": "string",
      "status": "FILE_STATUS_PUBLISHED",
      "status_message": "string"
    }
  ],
  "next_page_token": "string"
}

Create a file Public Preview

POST /api/2.0/marketplace-provider/files

Create a file. Currently, only provider icons and attached notebooks are supported.

API scopes: marketplace

Request body

file_parentobjectRequired

Show child attributesHide child attributes

parent_idstring

file_parent_typestring

Values:

• PROVIDER
• LISTING
• LISTING_RESOURCE

marketplace_file_typestringRequired

Values:

• PROVIDER_ICON
• EMBEDDED_NOTEBOOK
• APP

mime_typestringRequired

display_namestring

Response

upload_urlstring

Pre-signed POST URL to blob storage

file_infoobject

Show child attributesHide child attributes

idstring

marketplace_file_typestring

Values:

• PROVIDER_ICON
• EMBEDDED_NOTEBOOK
• APP

file_parentobject

Show child attributesHide child attributes

parent_idstring

file_parent_typestring

Values:

• PROVIDER
• LISTING
• LISTING_RESOURCE

mime_typestring

download_linkstring

created_atint64

updated_atint64

display_namestring

Name displayed to users for applicable files, e.g. embedded notebooks

statusstring

Values:

• FILE_STATUS_PUBLISHED
• FILE_STATUS_STAGING
• FILE_STATUS_SANITIZING
• FILE_STATUS_SANITIZATION_FAILED

status_messagestring

Populated if status is in a failed state with more information on reason for the failure.

View as Markdown

Request

{
  "file_parent": {
    "parent_id": "string",
    "file_parent_type": "PROVIDER"
  },
  "marketplace_file_type": "PROVIDER_ICON",
  "mime_type": "string",
  "display_name": "string"
}

Response

{
  "upload_url": "string",
  "file_info": {
    "id": "string",
    "marketplace_file_type": "PROVIDER_ICON",
    "file_parent": {},
    "mime_type": "string",
    "download_link": "string",
    "created_at": 0,
    "updated_at": 0,
    "display_name": "string",
    "status": "FILE_STATUS_PUBLISHED",
    "status_message": "string"
  }
}

Delete a file Public Preview

DELETE /api/2.0/marketplace-provider/files/{file_id}

Delete a file

API scopes: marketplace

Parameters

file_idstringRequiredpath

View as Markdown

Response

{}