PUT /v1/admin/tenants/{tenant_id}

Family: Platform admin · Operation ID: update_tenant

Access

Private platform operator API. Requires x-reacher-secret on the internal backend and explicit operator authorization. Workspace API keys cannot call this route.

Open platform operations

Replace each {parameter} segment in the path with its URL-encoded value.

Parameters

[
  {
    "description": "Tenant identifier",
    "in": "path",
    "name": "tenant_id",
    "required": true,
    "schema": {
      "type": "string"
    }
  }
]

Request body · application/json

{
  "$ref": "#/components/schemas/AdminUpdateTenantRequest",
  "definition": {
    "properties": {
      "contact_email": {
        "format": "email",
        "type": "string"
      },
      "default_webhook_url": {
        "nullable": true,
        "type": "string"
      },
      "max_requests_per_day": {
        "format": "int32",
        "type": "integer"
      },
      "max_requests_per_hour": {
        "format": "int32",
        "type": "integer"
      },
      "max_requests_per_minute": {
        "format": "int32",
        "type": "integer"
      },
      "max_requests_per_second": {
        "format": "int32",
        "type": "integer"
      },
      "monthly_email_limit": {
        "format": "int32",
        "nullable": true,
        "type": "integer"
      },
      "name": {
        "type": "string"
      },
      "plan_tier": {
        "type": "string"
      },
      "result_retention_days": {
        "format": "int32",
        "type": "integer"
      },
      "status": {
        "type": "string"
      },
      "webhook_signing_secret": {
        "nullable": true,
        "type": "string"
      }
    },
    "type": "object"
  }
}

Responses

200

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/AdminTenant"
      }
    }
  },
  "description": "Tenant updated"
}

default

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract