Account

Endpoints for the user behind a Bearer token. For the team-level container, see Environment.

Get the signed-in user

GET /user/self

Scope: user

Resolves the credentials to a user record — the REST equivalent of fused.api.whoami() and fused whoami.

Field	Type	Description
id	string	User id
name	string	Display name
email	string | null	Email address
handle	string | null	Public handle, used in canvas and UDF URLs
execution_environment_id	string | null	Environment the user belongs to
signup_date	string | null	Signup timestamp
handle_last_changed	string | null	When the handle was last changed

note

This endpoint requires a Bearer token. A service account token resolves to an environment rather than a user, so it returns 403 Forbidden — use GET /execution-env/self instead.

Update the signed-in user

POST /user/self

Scope: user

Updates your own profile. Only two fields may be changed:

Field	Type	Description
name	string	Display name
handle	string	Public handle

curl -X POST \
  -H "Authorization: Bearer $FUSED_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"handle": "my-handle"}' \
  "https://www.fused.io/server/v1/user/self"

Handle changes are validated:

Status	Cause
409 Conflict	The handle is already taken, or is reserved
422 Unprocessable Entity	The handle is an empty string
401 Unauthorized	The request attempted to change a field you may not set — anything other than name and handle

warning

Your handle appears in canvas and UDF URLs. Changing it can break links that address your work by handle.

See also

• Environment — the team-level container and its service accounts
• fused whoami — the CLI equivalent