Queries

circle-exclamation

roles

Lists roles for an organization.

roles(
    organizationId: ID!
    filter: CatalogItemFilter
    first: Int
    after: String
    last: Int
    before: String
    orderBy: CatalogItemOrder = { field: ORDER, direction: ASC }
  ): RoleConnection!

Arguments

Name
Type
Description

organizationId

ID!

The organization to retrieve roles for.

filter

CatalogItemFilter

Filtering options for the returned roles.

first

Int

The first n elements from the paginated listarrow-up-right.

after

String

The elements that come after the specified cursorarrow-up-right.

last

Int

The last n elements from the paginated listarrow-up-right.

before

String

The elements that come before the specified cursorarrow-up-right.

orderBy

CatalogItemOrder

The ordering options for the returned roles.

Input types:

chevron-rightCatalogItemFilterhashtag

Filtering options for catalog items.

Field
Type
Description

titleContains

String

Partial match on title (case-insensitive contains).

codes

[Code!]

Match any of these codes.

chevron-rightCatalogItemOrderhashtag

Ordering options for catalog items.

Field
Type
Description

field

The field to order by.

direction

The direction to order.

Output types:

chevron-rightRoleConnectionhashtag

A paginated list of Role items.

Implements: Connection

Field
Type
Description

edges

A list of edges.

nodes

[Role!]!

A list of nodes in the connection (without edge metadata).

pageInfo

Information about the current page.

total

The total count of items matching the filter.

chevron-rightPageInfo (entity)hashtag

Information about the current page in a paginated connection.

Field
Type
Description

hasNextPage

Boolean!

Whether more items exist after the current page.

hasPreviousPage

Boolean!

Whether more items exist before the current page.

startCursor

String

The cursor pointing to the first item in the current page.

endCursor

String

The cursor pointing to the last item in the current page.


actorRoles

Lists actor role assignments for an organization.

Arguments

Name
Type
Description

organizationId

ID!

The organization to retrieve actor roles for.

filter

ActorRoleFilter

Filtering options for the returned actor roles.

first

Int

The first n elements from the paginated listarrow-up-right.

after

String

The elements that come after the specified cursorarrow-up-right.

last

Int

The last n elements from the paginated listarrow-up-right.

before

String

The elements that come before the specified cursorarrow-up-right.

orderBy

ActorRoleOrder

The ordering options for the returned actor roles.

Input types:

chevron-rightActorRoleFilterhashtag

Filtering options for actor roles.

Field
Type
Description

actorIds

[ID!]

Filter by actors (OR within field).

roleIds

[ID!]

Filter by roles (OR within field).

includeExpired

Boolean

Include expired role assignments.

chevron-rightActorRoleOrderhashtag

Ordering options for actor roles.

Field
Type
Description

field

The field to order by.

direction

The direction to order.

Output types:

chevron-rightActorRoleConnectionhashtag

A paginated list of ActorRole items.

Implements: Connection

Field
Type
Description

edges

A list of edges.

nodes

A list of nodes in the connection (without edge metadata).

pageInfo

Information about the current page.

total

The total count of items matching the filter.

chevron-rightPageInfo (entity)hashtag

Information about the current page in a paginated connection.

Field
Type
Description

hasNextPage

Boolean!

Whether more items exist after the current page.

hasPreviousPage

Boolean!

Whether more items exist before the current page.

startCursor

String

The cursor pointing to the first item in the current page.

endCursor

String

The cursor pointing to the last item in the current page.


rolePermissions

Lists role permissions for an organization.

Arguments

Name
Type
Description

organizationId

ID!

The organization to retrieve role permissions for.

filter

RolePermissionFilter

Filtering options for the returned role permissions.

first

Int

The first n elements from the paginated listarrow-up-right.

after

String

The elements that come after the specified cursorarrow-up-right.

last

Int

The last n elements from the paginated listarrow-up-right.

before

String

The elements that come before the specified cursorarrow-up-right.

orderBy

RolePermissionOrder

The ordering options for the returned role permissions.

Input types:

chevron-rightRolePermissionFilterhashtag

Filtering options for role permissions.

Field
Type
Description

roleIds

[ID!]

Filter by roles (OR within field).

permissionScopeIds

[ID!]

Filter by permission scopes (OR within field).

targetEntityIds

[ID!]

Filter by target entities (OR within field).

chevron-rightRolePermissionOrderhashtag

Ordering options for role permissions.

Field
Type
Description

field

The field to order by.

direction

The direction to order.

Output types:

chevron-rightRolePermissionConnectionhashtag

A paginated list of RolePermission items.

Implements: Connection

Field
Type
Description

edges

A list of edges.

nodes

A list of nodes in the connection (without edge metadata).

pageInfo

Information about the current page.

total

The total count of items matching the filter.

chevron-rightPageInfo (entity)hashtag

Information about the current page in a paginated connection.

Field
Type
Description

hasNextPage

Boolean!

Whether more items exist after the current page.

hasPreviousPage

Boolean!

Whether more items exist before the current page.

startCursor

String

The cursor pointing to the first item in the current page.

endCursor

String

The cursor pointing to the last item in the current page.


userScopes

Lists user scope restrictions for an organization.

Arguments

Name
Type
Description

organizationId

ID!

The organization to retrieve user scopes for.

filter

UserScopeFilter

Filtering options for the returned user scopes.

first

Int

The first n elements from the paginated listarrow-up-right.

after

String

The elements that come after the specified cursorarrow-up-right.

last

Int

The last n elements from the paginated listarrow-up-right.

before

String

The elements that come before the specified cursorarrow-up-right.

orderBy

UserScopeOrder

The ordering options for the returned user scopes.

Input types:

chevron-rightUserScopeFilterhashtag

Filtering options for user scopes.

Field
Type
Description

actorIds

[ID!]

Filter by actors (OR within field).

permissionScopeIds

[ID!]

Filter by permission scopes (OR within field).

targetEntityIds

[ID!]

Filter by target entities (OR within field).

chevron-rightUserScopeOrderhashtag

Ordering options for user scopes.

Field
Type
Description

field

The field to order by.

direction

The direction to order.

Output types:

chevron-rightUserScopeConnectionhashtag

A paginated list of UserScope items.

Implements: Connection

Field
Type
Description

edges

A list of edges.

nodes

A list of nodes in the connection (without edge metadata).

pageInfo

Information about the current page.

total

The total count of items matching the filter.

chevron-rightPageInfo (entity)hashtag

Information about the current page in a paginated connection.

Field
Type
Description

hasNextPage

Boolean!

Whether more items exist after the current page.

hasPreviousPage

Boolean!

Whether more items exist before the current page.

startCursor

String

The cursor pointing to the first item in the current page.

endCursor

String

The cursor pointing to the last item in the current page.


Last updated

Was this helpful?