Role

Authentication

You're not signed in. Either sign in at app.saasflow.com and reload (then pick sessionCookie), or paste a SaaSFlow sf_… API key in the bearerAuth field below.

Authorization

Authorization<token>

A SaaSFlow API key (format sf_…) or an OAuth bearer token. Paste only the key — the proxy adds the Bearer prefix. Create an API key in Settings → Company settings → API keys — see API keys.

In: header

Path Parameters

companyId*string

Length1 <= length

userId*string

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

role*string

The role assigned to a user within the system. Owner = full access incl. company settings, billing, and user management; editor = read/write on data; viewer = read-only. The role is also used as the default permission preset and as a non-permission marker (e.g. notifications are sent to all owners). For granular API access control, see PermissionSchema.

Value in"owner" | "editor" | "viewer"

permissions?array<>|null

Response Body

`application/json`

curl -X PUT "https://api.saasflow.com/companies/string/users/string/role" \  -H "Content-Type: application/json" \  -d '{    "role": "owner"  }'

{
  "success": true
}

{
  "error": "string"
}

{
  "error": "string"
}

Authorization

Path Parameters

Request Body

Response Body

200application/json

403application/json

404application/json

`application/json`

`application/json`

`application/json`