Current user

Retrieve and update authenticated user's profile information and session details.

Get Current User Details

GET /v1/current-user

Get details about the currently logged in user.

Response (200 OK):

{
    "id": "56d4b940-ae51-4515-b207-f63328a66b32",
    "fsidUserId": "56d4b940-ae51-4515-b207-f63328a66b32",
    "organizationId": "63a07d66-1165-11f0-81d3-0efac543e13f",
    "firstName": "Joe",
    "lastName": "Test",
    "email": "[email protected]",
    "avatarUrl": null,
    "role": "builder",
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "fsidUrl": "https://admin.formstack.com",
    "canSwitchOrganizations": false,
    "canAccessSubaccounts": false,
    "sessionIdHmac": "hmac_string_here",
    "parentOrg": null,
    "__fsidPermissions": {
        "api-keys.manage.own": true,
        "api-keys.manage.all": false
    }
}

Update Current User

PUT /v1/current-user

Update current user information.

Request Body:

Required fields:

  • firstName
  • lastName
  • email
{
    "firstName": "Joe",
    "lastName": "Test",
    "email": "[email protected]"
}

Response (200 OK):

Returns the updated user object with the same structure as "Get Current User Details".

{
    "id": "56d4b940-ae51-4515-b207-f63328a66b32",
    "fsidUserId": "56d4b940-ae51-4515-b207-f63328a66b32",
    "organizationId": "63a07d66-1165-11f0-81d3-0efac543e13f",
    "firstName": "Joe",
    "lastName": "Test",
    "email": "[email protected]",
    "avatarUrl": null,
    "role": "builder",
    "sessionId": "550e8400-e29b-41d4-a716-446655440000",
    "fsidUrl": "https://admin.formstack.com",
    "canSwitchOrganizations": false,
    "canAccessSubaccounts": false,
    "sessionIdHmac": "hmac_string_here",
    "parentOrg": null,
    "__fsidPermissions": {
        "api-keys.manage.own": true,
        "api-keys.manage.all": false
    }
}