User Management API

Users

Group Users

The user entity provides identifying information about members of your organization, teams, and spaces.

Note: The user object is owned by the individual whose account is associated with it. Only this individual can make changes to the user object, including deleting it. Organizations indirectly maintain control over users within the organization via the several membership objects described in this documentation.

Get all users in organization

Get all users

This endpoint returns a paginated collection of users who are members of this organization.

Organization owners and admins of the requested organization receive full user details. Members of the requested organization who are not owners or admins receive only a limited set of user information.

This endpoint is accessible by all members of the organization.

Query Parameters

NameDetailsDescription
skip, limit-Specify requested page of result set. See Pagination for more details.
queryFields searched: sys.id, firstName, lastName, emailSpecify a string to search for matching resources against. See Searching Multiple Attributes for more details.

Response for admin

1{
2    "total": 2,
3    "limit": 25,
4    "skip": 0,
5    "sys": {
6        "type": "Array"
7    },
8    "items": [
9        {
10            "firstName": "Sascha",
11            "lastName": "Konietzke",
12            "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg",
13            "email": "user@example.com",
14            "activated": true,
15            "signInCount": 1277,
16            "confirmed": true,
17            "2faEnabled": true,
18            "sys": {
19                "type": "User",
20                "id": "7uqvFPPLzgtVaezGvjA9U6",
21                "version": 1733,
22                "createdAt": "2013-04-11T20:04:37Z",
23                "updatedAt": "2017-09-20T08:51:45Z"
24            }
25        },
26        {
27            "firstName": "Steeephen",
28            "lastName": "Sugden",
29            "avatarUrl": "https://www.gravatar.com/avatar/792867cb6657d4b936e474374985e58f?s=50&d=https%3A%2F%2Fstatic.quirely.com%2Fgatekeeper%2Fusers%2Fdefault-f33548606250cac861471edee5f997d0f50c8ad0ff68a700c394330bf0938a96.png",
30            "email": "stephen@contentful.com",
31            "activated": true,
32            "signInCount": 4,
33            "confirmed": true,
34            "2faEnabled": true,
35            "sys": {
36                "type": "User",
37                "id": "3XdAASLq5SdkZ9B97bHhKW",
38                "version": 12,
39                "createdAt": "2014-06-26T15:21:46Z",
40                "updatedAt": "2015-12-01T14:40:35Z"
41            }
42        }
43    ]
44}

Response for non-admin

1{
2    "total": 1,
3    "limit": 25,
4    "skip": 0,
5    "sys": {
6        "type": "Array"
7    },
8    "items": [
9        {
10            "firstName": "Sascha",
11            "lastName": "Konietzke",
12            "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg",
13            "sys": {
14                "type": "User",
15                "id": "7uqvFPPLzgtVaezGvjA9U6",
16                "version": 1,
17                "createdAt": "2025-12-28T04:00:29Z",
18                "updatedAt": "2026-02-14T01:26:38Z"
19            }
20        }
21    ]
22}

Get all users in a space

Get all users

This endpoint returns a paginated list of all users in a space. Note that this includes both users who have access directly, via a space membership, as well as indirectly, via membership in a team that has access to the space via a team space membership.

This endpoint is accessible by all members of the space.

Query Parameters

NameDetailsDescription
skip, limit-Specify requested page of result set. See Pagination for more details.

The following response for this endpoint depends on the requester’s role in the space.

  • Admin requesters receive full user information.
  • Non-admin requesters receive a reduced (minified) representation of each user.

The top-level pagination structure of the response remains the same, but the fields returned for each user in items may differ.

Response for admin

1{
2    "total": 2,
3    "limit": 25,
4    "skip": 0,
5    "sys": {
6        "type": "Array"
7    },
8    "items": [
9        {
10            "firstName": "Sascha",
11            "lastName": "Konietzke",
12            "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg",
13            "email": "user@example.com",
14            "activated": true,
15            "signInCount": 1277,
16            "confirmed": true,
17            "2faEnabled": true,
18            "sys": {
19                "type": "User",
20                "id": "7uqvFPPLzgtVaezGvjA9U6",
21                "version": 1733,
22                "createdAt": "2013-04-11T20:04:37Z",
23                "updatedAt": "2017-09-20T08:51:45Z"
24            }
25        },
26        {
27            "firstName": "Steeephen",
28            "lastName": "Sugden",
29            "avatarUrl": "https://www.gravatar.com/avatar/792867cb6657d4b936e474374985e58f?s=50&d=https%3A%2F%2Fstatic.quirely.com%2Fgatekeeper%2Fusers%2Fdefault-f33548606250cac861471edee5f997d0f50c8ad0ff68a700c394330bf0938a96.png",
30            "email": "stephen@contentful.com",
31            "activated": true,
32            "signInCount": 4,
33            "confirmed": true,
34            "2faEnabled": true,
35            "sys": {
36                "type": "User",
37                "id": "3XdAASLq5SdkZ9B97bHhKW",
38                "version": 12,
39                "createdAt": "2014-06-26T15:21:46Z",
40                "updatedAt": "2015-12-01T14:40:35Z"
41            }
42        }
43    ]
44}

Note: Non-admin clients should not assume that all user attributes are present in the response. Fields such as email, activated, signInCount, confirmed, 2faEnabled, version, createdAt, and updatedAt may be omitted for non-admin requesters.

Response for non-admin

1{
2    "total": 2,
3    "limit": 25,
4    "skip": 0,
5    "sys": {
6        "type": "Array"
7    },
8    "items": [
9        {
10            "firstName": "Sascha",
11            "lastName": "Konietzke",
12            "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg",
13            "sys": {
14                "type": "User",
15                "id": "7uqvFPPLzgtVaezGvjA9U6"
16            }
17        },
18        {
19            "firstName": "Steeephen",
20            "lastName": "Sugden",
21            "avatarUrl": "https://www.gravatar.com/avatar/792867cb6657d4b936e474374985e58f?s=50&d=https%3A%2F%2Fstatic.quirely.com%2Fgatekeeper%2Fusers%2Fdefault-f33548606250cac861471edee5f997d0f50c8ad0ff68a700c394330bf0938a96.png",
22            "sys": {
23                "type": "User",
24                "id": "3XdAASLq5SdkZ9B97bHhKW"
25            }
26        }
27    ]
28}

Get a single user

Get a single user (organization-scoped)

Get a single user (space-scoped)

These endpoints return details about an existing user, either in the context of an organization or a space.

The first endpoint (scoped to an organization) is accessible to all organization members; the second (scoped to a space) is accessible to all members of that space.

Response

1{
2    "firstName": "Sascha",
3    "lastName": "Konietzke",
4    "avatarUrl": "http://a0.twimg.com/profile_images/148466442/sascha_konietzke_normal.jpg",
5    "email": "user@example.com",
6    "activated": true,
7    "signInCount": 1277,
8    "confirmed": true,
9    "2faEnabled": true,
10    "sys": {
11        "type": "User",
12        "id": "7uqvFPPLzgtVaezGvjA9U6",
13        "version": 1733,
14        "createdAt": "2013-04-11T20:04:37Z",
15        "updatedAt": "2017-09-20T08:51:45Z"
16    }
17}