Rivier/ Reference/ files

Record that something uses an asset

post/assets/{id}/usage

Before you call

Credential
Authorization: Bearer $KEY
Scope
files:write
Mcp
rivier_assets_record_usage
Graphql
Mutation.filesUsageRecord
Sdk
files.usage.record
Cli
files usage record

Parameters

  • idstring (uuid)required
    In the path

Request bodyapplication/json, required

  • userKindstringrequired
    One of: post, content_item, content_variant, campaign, agent, channel, page, persona, product, property, area, unit, amenity, rate_plan, extra, poi, policy, cms_entry, mail_message, other.
  • userIdstringrequired
    At most 200 characters.
  • rolestring
    At most 40 characters.
  • notestring
    At most 300 characters.
  • versionIdstring (uuid)

Responses

  • 201application/json
    Success

    object

  • 400application/json
    The request was malformed
    • errorstringrequired
    • messagestring
  • 401application/json
    No valid credential
    • errorstringrequired
    • messagestring
  • 403application/json
    The credential lacks the scope, origin or address
    • errorstringrequired
    • messagestring
  • 429application/json
    Over the key's rate limit; see Retry-After
    • errorstringrequired
    • messagestring

This page as Markdown