Organization Labels Provider - API Contract

GET /api/v1/organizations/api/v1/organizations/:org_id/labels

Load all label overrides for an organization

Public

Response Example

{
  "data": [
    {
      "key": "activity_type.BIZ_TRAVEL",
      "value": "Tjenestereise",
      "locale": "nb"
    },
    {
      "key": "activity_type.CONFERENCE",
      "value": "Fagsamling",
      "locale": "nb"
    },
    {
      "key": "activity_type.VOLUNTEER",
      "value": "Dugnad",
      "locale": "nb"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 3
  }
}

GET /api/v1/organizations/api/v1/organizations/:org_id/labels/:key

Get a specific label by key for an organization

Public

Response Example

{
  "key": "activity_type.BIZ_TRAVEL",
  "value": "Tjenestereise",
  "locale": "nb",
  "fallback": "Business Travel"
}

GET /api/v1/organizations/api/v1/organizations/:org_id/activity-types/:activity_type_id/label

Get the organization-specific display label for an activity type

Public

Response Example

{
  "activity_type_id": "at-001",
  "label": "Tjenestereise",
  "locale": "nb",
  "is_custom": true
}

PUT /api/v1/organizations/api/v1/organizations/:org_id/labels/:key

Create or update a label override for an organization

Public

Request Example

{
  "value": "Tjenestereise (innenlands)",
  "locale": "nb"
}

Response Example

{
  "key": "activity_type.BIZ_TRAVEL",
  "value": "Tjenestereise (innenlands)",
  "locale": "nb",
  "updated_at": "2026-03-26T14:20:00Z"
}

DELETE /api/v1/organizations/api/v1/organizations/:org_id/labels/:key

Remove a label override (revert to system default)

Public

Response Example

{
  "success": true,
  "key": "activity_type.BIZ_TRAVEL",
  "reverted_to_default": "Business Travel"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}