/catalog/data-asset/{id}

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Update Data Asset

Use this route to update the properties of an existing data asset in the catalog.

How to use

Provide the data asset id as a path parameter and send the fields to update in the request body.

Payload example

{
  "name": "Updated Asset Name",
  "description": "Updated description for this data asset",
  "tags": ["finance", "quarterly-report"],
  "embed": {
    "url": "https://example.com/embed"
  },
  "share_type": "public",
  "docs": "# Documentation\nThis asset contains quarterly financial data."
}

Body fields

  • name: new display name for the data asset;
  • description: updated description;
  • tags: array of tag strings to associate with the data asset;
  • embed (optional): object containing a url for embedding;
  • share_type (optional): sharing visibility — none, public, or private;
  • docs (optional): markdown documentation for the data asset.

Error scenarios

CodeErrorDescription
401UnauthenticatedInvalid or missing access-token header
403ForbiddenUser does not have the required permissions
404Not FoundThe requested data asset does not exist
500Internal Server ErrorUnknown server error
Path Params
string
required
Body Params
string
required
string
required
tags
array of strings
required
tags*
embed
object
string
enum
Allowed:
Headers
string
enum
Allowed:
Response

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json