Upload key metrics

Key metrics belong to an internal project. On a revenue-linked project, use the Revenue API instead.

import weflayr

client = weflayr.client(api_key="wf-...")

const weflayr = require('weflayr');

const client = weflayr.client({ apiKey: 'wf-...' });

# Passed as a Bearer token on every request
export WEFLAYR_API_KEY="wf-..."

Set key metrics

A user can have several lines of the same metric in the same month (they add up):

from weflayr.openapi.models import SetKeyMetricsInput

client.set_key_metrics(body=SetKeyMetricsInput.from_dict({
    "rows": [
        {"user_name": "u_123", "metric_name": "Meetings booked", "amount": 3, "month": "2026-06"},
        {"user_name": "u_456", "metric_name": "Meetings booked", "amount": 7, "month": "2026-06"},
    ]
}))

await weflayr.api.setKeyMetrics({
  client,
  throwOnError: true,
  body: {
    rows: [
      { userName: 'u_123', metricName: 'Meetings booked', amount: 3, month: '2026-06' },
      { userName: 'u_456', metricName: 'Meetings booked', amount: 7, month: '2026-06' },
    ],
  },
});

curl -X POST https://app.weflayr.com/api/key-metrics/ \
  -H "Authorization: Bearer $WEFLAYR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "rows": [
      {"user_name": "u_123", "metric_name": "Meetings booked", "amount": 3, "month": "2026-06"},
      {"user_name": "u_456", "metric_name": "Meetings booked", "amount": 7, "month": "2026-06"}
    ]
  }'

Output:

{"ok": true, "rows_inserted": 2}

Input params:

array of row objects

required

The key-metric lines to book, described below. Up to 1,000 per call.

boolean

default:"false"

If a row’s metric_id already exists (c.f. rows parameters below), overwrite it instead of throwing an error.

Each object inside rows accepts:

string

required

The user the value belongs to.

string

required

Name of the key metric. The first time you post a new one, it’s automatically added to the project’s key metrics.

number

required

The value to book.

"YYYY-MM"

The calendar month the value belongs to. Required unless you set month_start and month_end instead.

"YYYY-MM"

Bill over a multi-month period (e.g. quarterly) instead of a single month. amount is split evenly over the period. Set either month, or both month_start and month_end, never both forms on the same row.

string

An id for the key-metric row over which uniqueness is checked, typically from your own tracking system.

API values are their own key-metric source, alongside CSV uploads. Sources add up: if you post a value for a user-month that also has a CSV upload, Weflayr assumes it is the sum. We recommend using one source only to avoid double counting.

Get key metrics

client.get_key_metrics(user_names=["u_123", "u_456"])

await weflayr.api.getKeyMetrics({
  client,
  throwOnError: true,
  query: { userNames: ['u_123', 'u_456'] },
});

curl "https://app.weflayr.com/api/key-metrics/?user_names=u_123&user_names=u_456" \
  -H "Authorization: Bearer $WEFLAYR_API_KEY"

Output:

{
  "rows": [
    {"metric_id": "b3f2b160-6e12-4f1a-9c3d-0a2e7c9b5d41", "user_name": "u_123", "metric_name": "Meetings booked", "month": "2026-06", "amount": 3.0, "source": "api"}
  ],
  "next_cursor": null,
  "has_more": false
}

Input params: passed in the query string.

list[string]

Specify the names of the users whose key metrics should be fetched. Not setting it means “all users”.

integer

default:"100"

Numbers of rows to fetch. Max 1000.

string

The route is paginated: pass the previous page’s next_cursor to fetch the next page. PS: has_more from the output says whether another page exists.

Delete key metrics

client.delete_key_metrics(user_names=["u_123", "u_456"])

await weflayr.api.deleteKeyMetrics({
  client,
  throwOnError: true,
  query: { userNames: ['u_123', 'u_456'] },
});

curl -X DELETE "https://app.weflayr.com/api/key-metrics/?user_names=u_123&user_names=u_456" \
  -H "Authorization: Bearer $WEFLAYR_API_KEY"

Output:

{"ok": true, "rows_deleted": 2}

Input params: passed in the query string.

list[string]

required

Delete all these users’ API-booked key metrics.

"YYYY-MM"

Narrow the delete to this inclusive month range. Omit both to delete every API-booked value of the named users.

PS: CSV uploads are managed by their own source and cannot be deleted via this route

Get started

Technical documentation

Platform documentation

Set key metrics

Get key metrics

Delete key metrics

​Set key metrics

​Get key metrics

​Delete key metrics

Set key metrics

Get key metrics

Delete key metrics