Skip to content
Docs

API reference / Operations by tag

tenants

The current tenant: profile, usage and the config version that tracking nodes cache.

4 operations. Base URL https://api.metrixed.com/v1; see authentication, errors and pagination.

Operations

MethodPathSummary
GET/tenantCurrent tenant
PATCH/tenantUpdate tenant
GET/tenant/config-versionCurrent config version (edge snapshot)
GET/tenant/usagePlan usage meters

GET /tenant

Current tenant

Operation getTenant. Auth: API key (Bearer) or session cookie.

StatusDescriptionBody
200okapplication/json Tenant
defaulterrorapplication/json Error
bash
curl 'https://api.metrixed.com/v1/tenant' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json
{
  "external_ref": ""
}

PATCH /tenant

Update tenant

Operation patchTenant. Auth: API key (Bearer) or session cookie.

Request body (application/json, required): TenantUpdate

FieldTypeFlagsDescription
slugstring
namestring
planstring
statusenum: trial, active, suspended, closed
default_currencystring
reporting_timezonestring
caps_timezonestring
localestring
data_regionstring
modesarray of enum: network, program, app_attribution, media_buying, igaming, lead_gen
brandingobject (free-form)
portal_domainsobject (free-form)
terms_and_conditionsstring
signup_questions_partnerarray of object (free-form)
signup_questions_advertiserarray of object (free-form)
partner_signup_modestring
partner_visibility_defaultsobject (free-form)
feature_flagsobject (free-form)
retention_days_rawinteger
retention_days_aggregatesinteger
api_rate_limitsobject (free-form)
settingsobject (free-form)
StatusDescriptionBody
200okapplication/json Tenant
defaulterrorapplication/json Error
bash
curl -X PATCH 'https://api.metrixed.com/v1/tenant' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data-raw '{"slug":"","name":"","plan":"","status":"trial"}'

Example 200 response:

json
{
  "external_ref": ""
}

GET /tenant/config-version

Current config version (edge snapshot)

Operation getTenantConfigVersion. Auth: API key (Bearer) or session cookie.

StatusDescriptionBody
200okapplication/json Ok
defaulterrorapplication/json Error
bash
curl 'https://api.metrixed.com/v1/tenant/config-version' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json
{
  "ok": false
}

GET /tenant/usage

Plan usage meters

Operation getTenantUsage. Auth: API key (Bearer) or session cookie.

StatusDescriptionBody
200okapplication/json Usage
defaulterrorapplication/json Error
bash
curl 'https://api.metrixed.com/v1/tenant/usage' \
  -H "Authorization: Bearer $DT_API_KEY" \
  -H 'Accept: application/json'

Example 200 response:

json
{
  "period": "",
  "meters": [
    {}
  ],
  "limits": {}
}