Update an existing asset by ID

patch

https://api.spartera.com/companies/{company_id}/assets/{asset_id}

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

company_id

string

required

length between 1 and 255

^[a-zA-Z0-9_-]+$

Unique identifier for the Company

asset_id

string

required

length between 1 and 255

^[a-zA-Z0-9_-]+$

Unique identifier for the Asset

Body Params

Update schema for modifying Asset

user_id

string

References users.user_id — An individual user account within a company. See GET /users for valid values. Optional.

company_id

string

References companies.company_id — A Spartera seller or buyer company account. See GET /companies for valid values. Required.

connection_id

string

Optional.

industry_id

int64

References industries.industry_id — Available industry categories for asset classification. Based on US NAISC codes.. See GET /industries for valid values. Optional.

auc_id

int64

Primary use case for this asset, from clustering analysis

function_id

string

Optional identifier for routing to specific functions/models at seller endpoint. For GET: appended to URL path. For POST: included in JSON body.

approval_status

string

enum

Approval status for AI-generated assets

Allowed:

approved_by_user_id

string

User who approved this asset for marketplace

approved_at

date-time

When this asset was approved for marketplace

name

string

Required.

slug

string

Optional.

description

string

Optional.

detailed_description

string

Long-form HTML description for product pages and SEO

source

string

enum

Required. One of: MANUAL, AUTOMATIC.

Allowed:

asset_type

string

enum

Optional. One of: CALCULATION, VISUALIZATION, DATA.

Allowed:

asset_schema

object

Stores database table schema data including columns, types, and metadata

tags

string

Optional.

top_questions

string

Top 3 questions this asset can help answer, in English. Stored as JSON array of strings (1-3 items, 15-200 chars each). Required for marketplace assets.

short_code

string

Short code for tera.ac URL shortener (e.g., 'f78zq1')

restricted_domains

string

Semicolon or comma-separated list of domains restricted from accessing this asset

sql_logic

string

Optional.

source_schema_name

string

Optional.

source_table_name

string

Optional.

sell_in_marketplace

boolean

Required.

require_customization

boolean

Whether this asset requires customization before use

viz_spec

object

Plotly figure JSON describing the visualization. Authored via the visual editor or via API. When populated, takes precedence over the legacy viz_ fields. Shape follows Plotly's figure schema: {data: [{type: '...', xsrc: '...', ...}], layout: {...}}. Column references use src keys (xsrc, ysrc, labelssrc, etc.) and are hydrated with actual data at render time.

viz_chart_library

string

enum

Optional. One of: PLOTLY, MATPLOTLIB, SEABORN.

Allowed:

viz_chart_type

string

enum

Optional. One of: LINE, BAR, PIE, DOUGHNUT, POLAR, … (8 total).

viz_dep_var_col_name

string

Optional.

viz_indep_var_col_name

string

Optional.

viz_size_col_name

string

Optional.

viz_color_col_name

string

Optional.

viz_data_aggregation

string

enum

Optional. One of: No Aggregation, Sum, Average, Count, Minimum, … (6 total).

Allowed:

viz_sort_direction

string

enum

Optional. One of: No Sorting, Ascending, Descending.

Allowed:

viz_data_limit

int64

Optional.

viz_color_scheme

string

enum

Optional. One of: Default, Sequential, Diverging, Categorical, Monochrome, … (8 total).

viz_show_legend

boolean

Show/hide chart legend

viz_show_grid

boolean

Show/hide grid lines

viz_show_trendline

boolean

Show trendline for scatter/line charts

viz_line_smoothing

boolean

Enable smoothing for line charts

viz_bar_stacked

boolean

Stack bars instead of grouping

viz_filter_direction

string

enum

Whether data_limit shows TOP or BOTTOM N

Allowed:

allow_params

boolean

Required.

accept_terms

boolean

Required.

cached

boolean

Optional.

schedule

string

Optional.

next_run

date-time

Optional.

data_time_period_start

date-time

Start date of the data time period covered

data_time_period_end

date-time

End date of the data time period covered

date_collection_start

date-time

When the seller began actively collecting this data. Distinct from data_time_period_start, which describes when the records themselves begin. Backfilled historical data will have date_collection_start > data_time_period_start.

geographic_coverage_type

string

enum

Type of geographic coverage

geographic_coverage_details

string

Specific regions/countries covered (e.g., 'United States, Canada, Mexico')

data_source_refresh_frequency

string

enum

How often the source data is refreshed

rate_limit_number

int64

Number of requests allowed per period (e.g., 100)

rate_limit_period

string

enum

Time period for rate limiting (second, minute, hour, day)

Allowed:

rate_limit_granularity

string

enum

Granularity level for rate limiting (USER, COMPANY, IP)

Allowed:

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully updated assets

400Invalid input

401Authentication required

403Permission denied

404Resource not found

409Resource conflict (duplicate, constraint violation)

422Request well-formed but semantically invalid

429Rate limit exceeded

500Internal server error