REST API endpoint

GET /v1/responsibilities

Current team responsibilities for a tracker, including who is assigned to each visible role.

Request

GET https://api.nowmetrix.com/v1/responsibilities?site=TRACKER_ID

Use this endpoint to show who is currently responsible in an internal tool, without exposing email addresses or permission details.

Try in API Playground

Authentication

Requires an API key in the Authorization header: Authorization: Bearer nm_YOUR_KEY.

Query parameters

Name Type Required Description
site string required Tracker ID. The API key must have access to this tracker.

cURL example

curl -H "Authorization: Bearer nm_YOUR_KEY" \
  "https://api.nowmetrix.com/v1/responsibilities?site=TRACKER_ID"

Example response

{
  "site": "TRACKER_ID",
  "updated_at": "2026-06-26T14:24:30+02:00",
  "timezone": "Europe/Zurich",
  "active": true,
  "date": "2026-06-26",
  "responsibilities": [
    {
      "id": 12,
      "name": "Homepage",
      "assignee": {
        "id": 935,
        "name": "Maya Keller",
        "initials": "MK",
        "avatar_url": "https://imagedelivery.net/example/avatar/public"
      },
      "assigned_at": "2026-06-26 09:14:22"
    },
    {
      "id": 13,
      "name": "Video",
      "assignee": null,
      "assigned_at": null
    }
  ]
}

Response fields

Field Type Description
site string Tracker ID used for the request.
updated_at string Timestamp in the tracker timezone.
timezone string Tracker timezone.
active boolean Whether responsibility tracking is active for this tracker.
date string Local tracker date in YYYY-MM-DD format.
responsibilities[] array<object> Visible responsibility roles.
responsibilities[].id integer Role ID.
responsibilities[].name string Role name.
responsibilities[].assignee object|null Assigned user, or null if nobody is assigned.
responsibilities[].assignee.id integer Assigned user ID.
responsibilities[].assignee.name string Assigned user's display name.
responsibilities[].assignee.initials string Assigned user's initials.
responsibilities[].assignee.avatar_url string Avatar URL, or an empty string if no avatar is available.
responsibilities[].assigned_at string|null Assignment timestamp, or null if nobody is assigned.

Freshness and caching

Responses are microcached per account, tracker, and assignment cache version for 10 seconds, with a 60-second stale window.

Errors

HTTP Code Description
400 site_required The required site parameter is missing.
401 missing_token The Authorization header is missing.
401 invalid_token The token is invalid or revoked.
403 site_not_authorized The API key has no access to this tracker.
429 rate_limit_exceeded The rate limit has been exceeded.
503 redis_unavailable The realtime backend is temporarily unavailable.
403 account_not_resolved The account context could not be resolved.
500 encoding_failed The response could not be encoded. 
{
  "error": {
    "code": "invalid_token",
    "message": "Bearer token is invalid or revoked."
  }
}