> For AI agents: [llms.txt](https://docs.trustedauth.com/llms.txt) provides a Markdown index of this documentation.

# Grids

Grid controllers

[📄️Create unassigned grids Create the specified number of unassigned grids. Caller requires the GRIDS:ADD permission.](/api/openapi/admin-api/create-unassigned-grids-using-post.md)

[📄️Get grid properties Get grid properties. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/get-grid-properties-using-get.md)

[📄️Email a grid card to the card owner Email a grid card to the card owner. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/deliver-assigned-grid-by-email-using-post.md)

[📄️Export a grid to PDF format Export a grid to PDF format. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/get-single-grid-export-using-get.md)

[📄️Assign a grid to a user by serial number Assign the specified grid to a user. Caller requires the GRIDS:EDIT permission.](/api/openapi/admin-api/assign-grid-by-id-using-put.md)

[📄️Unassign a grid Unassigned the specified grid. Caller requires the GRIDS:EDIT permission.](/api/openapi/admin-api/unassign-grid-using-put.md)

[📄️Lists a page of unassigned grids Returns unassigned grids for the provided search parameters. Caller requires the GRIDS:VIEW permission. The following searchByAttributes are supported: <ul><li>serialNumber: a numeric value. Allowed operators are: EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>createDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>groupId: a String value should be a UUID of an existing group. Allowed operator: EQUALS. </li></ul>If you provide more than one search attribute, they are joined with an AND condition.<br /><br />The orderByAttribute supports these attribute names: serialNumber, createDate.](/api/openapi/admin-api/unassigned-grids-page-using-post.md)

[📄️Assign a user to a grid Assign the specified user a grid. Caller requires the GRIDS:EDIT permission.](/api/openapi/admin-api/assign-grid-by-serial-number-using-put.md)

[📄️Lists a page of assigned grids asynchronously Returns assigned grids for the provided search parameters. Caller requires the GRIDS:VIEW permission. The following searchByAttributes are supported: <ul><li>serialNumber: a numeric value. Allowed operators are: EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>state: ACTIVE, INACTIVE, PENDING, CANCELED. Allowed operator: EQUALS.</li><li>expired: 'true' is the only value allowed. Allowed operator: EQUALS. </li><li>createDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>expiryDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>lastUsedDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>userId: a String value. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH. </li><li>groupId: a String value should be a UUID of an existing group. Allowed operator: EQUALS. </li></ul>If you provide more than one search attribute, they are joined with an AND condition.<br /><br />The orderByAttribute supports these attribute names: serialNumber, state, createDate, expiryDate, lastUsedDate, userId.<br />The results will only include grids that contain data in the orderByAttribute selected.](/api/openapi/admin-api/assigned-grids-page-async-using-post.md)

[📄️Lists a page of unassigned grids asynchronously Returns unassigned grids for the provided search parameters. Caller requires the GRIDS:VIEW permission. The following searchByAttributes are supported: <ul><li>serialNumber: a numeric value. Allowed operators are: EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>createDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>groupId: a String value should be a UUID of an existing group. Allowed operator: EQUALS. </li></ul>If you provide more than one search attribute, they are joined with an AND condition.<br /><br />The orderByAttribute supports these attribute names: serialNumber, createDate.](/api/openapi/admin-api/unassigned-grids-page-async-using-post.md)

[📄️Get the result of an asynchronous list assigned grids operation Get the result of an asynchronous list assigned grids operation. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/assigned-grids-page-async-result-using-get.md)

[📄️Get the status of an asynchronous list assigned grids operation Get the status of an asynchronous list assigned grids operation. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/assigned-grids-page-async-status-using-get.md)

[📄️Get the result of an asynchronous list unassigned grids operation Get the result of an asynchronous list unassigned grids operation. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/unassigned-grids-page-async-result-using-get.md)

[📄️Get the status of an asynchronous list unassigned grids operation Get the status of an asynchronous list unassigned grids operation. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/unassigned-grids-page-async-status-using-get.md)

[📄️Get a grid by serial number Get the grid for the specified serial number. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/get-grid-by-serial-number-using-get.md)

[📄️Get a grid Get the specified grid. Caller requires the GRIDS:VIEW permission.](/api/openapi/admin-api/get-grid-using-get.md)

[📄️Modify unassigned grid Modify the specified unassigned grid. Caller requires the GRIDS:EDIT permission.](/api/openapi/admin-api/modify-unassigned-grid-using-put.md)

[📄️Delete a grid Delete the specified grid. Caller requires the GRIDS:REMOVE permission.](/api/openapi/admin-api/delete-grid-using-delete.md)

[📄️Change state of grid Change the state of the specified grid. Caller requires the GRIDS:EDIT permission.](/api/openapi/admin-api/change-grid-state-using-put.md)

[📄️Lists a page of assigned grids Returns assigned grids for the provided search parameters. Caller requires the GRIDS:VIEW permission. The following searchByAttributes are supported: <ul><li>serialNumber: a numeric value. Allowed operators are: EQUALS, GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>state: ACTIVE, INACTIVE, PENDING, CANCELED. Allowed operator: EQUALS.</li><li>expired: 'true' is the only value allowed. Allowed operator: EQUALS. </li><li>createDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>expiryDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>lastUsedDate: a String value representing an ISO-8601 date in UTC time (e.g., 2018-08-04T18:15:30). Allowed operators are: GREATER_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN, LESS_THAN_OR_EQUAL.</li><li>userId: a String value. Allowed operators are: EQUALS, NOT_EQUALS, CONTAINS, NOT_CONTAINS, STARTS_WITH, ENDS_WITH. </li><li>groupId: a String value should be a UUID of an existing group. Allowed operator: EQUALS. </li></ul>If you provide more than one search attribute, they are joined with an AND condition.<br /><br />The orderByAttribute supports these attribute names: serialNumber, state, createDate, expiryDate, lastUsedDate, userId.<br />The results will only include grids that contain data in the orderByAttribute selected.](/api/openapi/admin-api/assigned-grids-page-using-post.md)

[📄️Create a grid Create a grid for the specified user. Caller requires the GRIDS:ADD permission.](/api/openapi/admin-api/create-grid-using-post.md)