---
canonical: https://amplience.com/developers/docs/apis/asset-management/reference/objects/organization/
title: "Objects: Organization & users"
description: GraphQL object types for organizations, teams, users, invitations, and personal access tokens in the Amplience GraphQL Management API.
audience: Developer
date_published: 2023-05-26
date_modified: 2026-07-20
---
# Objects: Organization & users
GraphQL object types for organizations, teams, users, invitations, and personal access tokens in the Amplience GraphQL Management API.
## Organizations, plans & credits
### Organization
*Implements: [Node](https://amplience.com/developers/docs/apis/asset-management/reference/interfaces#node)*
| Field | Type | Description |
|---|---|---|
| `id` | `ID`! | The ID of the object |
| `userPermissions` | \[[OrganizationPermission](https://amplience.com/developers/docs/apis/asset-management/reference/enums#organizationpermission)!\]! | |
| `name` | `String` | Organization name |
| `label` | `String` | Organization label |
| `invitations` | `InvitationConnection` |
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
| `members` | `UserConnection` |
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
| `creditBalance` | [CreditBalance](#creditbalance) | |
| `creditTransactionReport` | [CreditTransactionReport](#credittransactionreport) |
*Args: `input:` [CreditTransactionReportFilterInput](https://amplience.com/developers/docs/apis/asset-management/reference/inputs/teams#credittransactionreportfilterinput)* |
| `entitlements` | \[[Entitlement](#entitlement)\] | |
| `plans` | \[[Plan](#plan)\] | |
| `cmsHubs` | \[[CMSHub](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmshub)!\]! | |
| `personalAccessTokenRequests` | \[[PersonalAccessTokenRequest](#personalaccesstokenrequest)!\]! | |
| `teams` | \[[Team](#team)!\]! | |
| `virtualStagingEnvironments` | `VirtualStagingEnvironment`
`Connection`! | Only VSEs that have been created with an organizationId will be listed here. This generally applies to newly created VSEs only since October 2025.
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
| `previewKeys` | `PreviewKeyConnection`! |
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
### CreditBalance
| Field | Type | Description |
|---|---|---|
| `balance` | `BigInteger` | |
| `creditAllowance` | `BigInteger` | |
| `organization` | [Organization](#organization) | |
| `quotaPeriod` | `String` | |
### CreditTransactionReport
| Field | Type | Description |
|---|---|---|
| `reportURL` | `String` | |
### Entitlement
| Field | Type | Description |
|---|---|---|
| `organization` | [Organization](#organization)! | |
| `name` | `String`! | |
| `label` | `String`! | |
| `type` | [EntitlementValueType](https://amplience.com/developers/docs/apis/asset-management/reference/enums#entitlementvaluetype)! | |
| `value` | `EntitlementValue`! | |
### Plan
| Field | Type | Description |
|---|---|---|
| `organization` | [Organization](#organization)! | |
| `name` | `String`! | |
| `entitlements` | \[[Entitlement](#entitlement)!\]! | |
### Provider
| Field | Type | Description |
|---|---|---|
| `label` | `String`! | |
| `imageFile` | `String`! | |
## Teams, users & invitations
### Team
*Implements: [Node](https://amplience.com/developers/docs/apis/asset-management/reference/interfaces#node)*
| Field | Type | Description |
|---|---|---|
| `id` | `ID`! | The ID of the object |
| `assignedOrganizationRoles` | \[[OrganizationRolesTeamAssignment](#organizationrolesteamassignment)!\] | Team's organization roles |
| `assignedCMSHubRoles` | \[[CMSHubRolesTeamAssignment](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmshubrolesteamassignment)!\] | Team's CMS Hub roles |
| `assignedCMSRepositoryRoles` | \[[CMSRepositoryRolesTeamAssignment](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmsrepositoryrolesteamassignment)!\] | Team's CMS Repository roles |
| `organization` | [Organization](#organization)! | Organization that this team belongs to |
| `label` | `String`! | Team label |
| `createdDate` | `DateTime`! | Date team was created |
| `updatedDate` | `DateTime`! | Date team was last updated |
| `createdBy` | [User](#user)! | The user that created the team |
| `updatedBy` | [User](#user)! | The user that last updated the team |
| `isOnboarding` | `Boolean`! | Automatically add new users to this team on their first login if no specific team is assigned via an invite. |
| `members` | `TeamMembersConnection`! |
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
### User
*Implements: [Node](https://amplience.com/developers/docs/apis/asset-management/reference/interfaces#node)*
| Field | Type | Description |
|---|---|---|
| `id` | `ID`! | |
| `mediaHubs` | `MediaHubConnection` |
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
| `videoTranscodingProfiles` | `VideoTranscodingProfile`
`Connection` | |
| `email` | `String` | Member's email address |
| `picture` | `String` | Member's avatar |
| `name` | `String` | Member's name |
| `loginDateTime` | `String` | Member's last Login timestamp |
| `isSSO` | `String` | Has member logged in via SSO |
| `orgId` | `String` | |
| `organizations` | `OrganizationConnection`! |
*Args: `before: String`, `after: String`, `first: Int`, `last: Int`* |
| `personalAccessTokens` | \[[PersonalAccessToken](#personalaccesstoken)!\]! | |
| `personalAccessTokenRequests` | \[[PersonalAccessTokenRequest](#personalaccesstokenrequest)!\]! | |
| `assignedOrganizationRoles` | \[[OrganizationRolesUserAssignment](#organizationrolesuserassignment)!\] | User's organization roles |
| `assignedCMSHubRoles` | \[[CMSHubRolesUserAssignment](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmshubrolesuserassignment)!\] | User's CMS Hub roles |
| `assignedCMSRepositoryRoles` | \[[CMSRepositoryRolesUserAssignment](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmsrepositoryrolesuserassignment)!\] | User's CMS Repository roles |
| `teams` | \[[Team](#team)!\]! |
*Args: `organizationId: ID`* |
### Invitation
*Implements: [Node](https://amplience.com/developers/docs/apis/asset-management/reference/interfaces#node)*
| Field | Type | Description |
|---|---|---|
| `id` | `ID`! | The ID of the object |
| `invitee` | `String` | Users email address |
| `assignedOrganizationRoles` | \[[OrganizationRoles](#organizationroles)!\] | Invitation's organization roles |
| `assignedCMSHubRoles` | \[[CMSHubRoles](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmshubroles)!\] | Invitation's CMS Hub roles |
| `assignedCMSRepositoryRoles` | \[[CMSRepositoryRoles](https://amplience.com/developers/docs/apis/asset-management/reference/objects/cms#cmsrepositoryroles)!\] | Invitation's CMS Repository roles |
| `teams` | \[[Team](#team)!\] | Teams to be assigned to the user |
## Role assignments
### OrganizationRoles
| Field | Type | Description |
|---|---|---|
| `organizationId` | `ID`! | ID of the Organization that these role assignments correspond to |
| `roles` | \[[OrganizationRole](https://amplience.com/developers/docs/apis/asset-management/reference/enums#organizationrole)!\]! | List of organization roles assigned to this user |
### OrganizationRolesTeamAssignment
| Field | Type | Description |
|---|---|---|
| `organizationId` | `ID`! | ID of the Organization that these role assignments correspond to |
| `teamId` | `ID`! | ID of the Team that these role assignments correspond to |
| `lastModified` | `DateTime`! | The Last Modified date |
| `roles` | \[[OrganizationRole](https://amplience.com/developers/docs/apis/asset-management/reference/enums#organizationrole)!\]! | List of organization roles assigned to this Team |
### OrganizationRolesUserAssignment
| Field | Type | Description |
|---|---|---|
| `organizationId` | `ID`! | ID of the Organization that these role assignments correspond to |
| `userId` | `ID`! | ID of the User that these role assignments correspond to |
| `roles` | \[[OrganizationRole](https://amplience.com/developers/docs/apis/asset-management/reference/enums#organizationrole)!\]! | List of organization roles assigned to this user |
## Personal access tokens
### PersonalAccessToken
*Implements: [Node](https://amplience.com/developers/docs/apis/asset-management/reference/interfaces#node)*
| Field | Type | Description |
|---|---|---|
| `id` | `ID`! | |
| `name` | `String`! | |
| `token` | `String`! | |
| `createdDate` | `DateTime`! | |
| `lastUsedDate` | `DateTime` | |
| `user` | [User](#user)! | |
| `organization` | [Organization](#organization)! | |
### PersonalAccessTokenRequest
| Field | Type | Description |
|---|---|---|
| `id` | `ID`! | |
| `name` | `String`! | |
| `token` | `String`! | |
| `createdDate` | `DateTime`! | |
| `lastUsedDate` | `DateTime` | |
| `requestedBy` | [User](#user)! | |
| `organization` | [Organization](#organization)! | |
### UpdatePersonalAccessTokenResponse
| Field | Type | Description |
|---|---|---|
| `user` | `String`! | |
| `id` | `ID`! | |