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

# Tokens

Token controllers

[📄️Lists a page of assigned tokens asynchronously Returns assigned tokens for the provided search parameters. Caller requires the TOKENS:VIEW permission.The following searchByAttributes are supported: <ul><li>state: NEW, ACTIVE, ACTIVATING or INACTIVE. Allowed operator: EQUALS.</li><li>serialNumber: a String up to 100 characters. Allowed operators are: EQUALS, CONTAINS, STARTS_WITH.</li><li>type: ENTRUST_SOFT_TOKEN, GOOGLE_AUTHENTICATOR, OATH_PHYSICAL_TOKEN or ENTRUST_LEGACY_TOKEN. Allowed operator: EQUALS.</li><li>loadDate: 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, EXISTS, NOT_EXISTS.</li><li>groupId: a String value should be a UUID of an existing group. Allowed operator: EQUALS. </li><li>label: a String up to 100 characters. Allowed operator: CONTAINS. </li></ul>The orderByAttribute supports these attribute names: serialNumber, state, loadDate or lastUsedDate.Sorting by attributes containing Null values such as lastUsedDate is not possible. Therefore, any record containing Null in the orderByAttribute will be filtered out before doing the sorting.](/api/openapi/admin-api/assigned-token-page-async-using-post.md)

[📄️Lists a page of unassigned hardware tokens asynchronously Returns unassigned hardware tokens for the provided search parameters. Caller requires the TOKENS:VIEW permission.The following searchByAttributes are supported: <ul><li>serialNumber: a String up to 100 characters. Allowed operators are: EQUALS, CONTAINS, STARTS_WITH.</li><li>type: OATH_PHYSICAL_TOKEN or ENTRUST_LEGACY_TOKEN. Allowed operator: EQUALS.</li><li>loadDate: 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>The orderByAttribute supports these attribute names: serialNumber.](/api/openapi/admin-api/unassigned-token-page-async-using-post.md)

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

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

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

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

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

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

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

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

[📄️Complete token activation Complete activation of the given token. Caller requires the TOKENS:ADD permission.](/api/openapi/admin-api/complete-activate-token-using-put.md)

[📄️Start token activation Start activation of the given token. Caller requires the TOKENS:ADD permission.](/api/openapi/admin-api/start-activate-token-using-post.md)

[📄️Assign token to user Given a hardware token, assign it to a user. Caller requires the TOKENS:EDIT permission.](/api/openapi/admin-api/assign-token-by-id-using-put.md)

[📄️Modify an assigned token Modify an assigned token. Caller requires the TOKENS:EDIT permission.](/api/openapi/admin-api/modify-assigned-token-using-put.md)

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

[📄️Reset a token Reset a token. Caller requires the TOKENS:EDIT permission.](/api/openapi/admin-api/reset-token-using-put.md)

[📄️Unassign a token Unassign a token from a user. Caller requires the TOKENS:EDIT permission.](/api/openapi/admin-api/unassign-token-using-put.md)

[📄️Token PIN unlock Unlock a token PIN. Caller requires the TOKENS:EDIT permission.](/api/openapi/admin-api/unlock-token-using-put.md)

[📄️Lists a page of assigned tokens Returns assigned tokens for the provided search parameters. Caller requires the TOKENS:VIEW permission.The following searchByAttributes are supported: <ul><li>state: NEW, ACTIVE, ACTIVATING or INACTIVE. Allowed operator: EQUALS.</li><li>serialNumber: a String up to 100 characters. Allowed operators are: EQUALS, CONTAINS, STARTS_WITH.</li><li>type: ENTRUST_SOFT_TOKEN, GOOGLE_AUTHENTICATOR, OATH_PHYSICAL_TOKEN or ENTRUST_LEGACY_TOKEN. Allowed operator: EQUALS.</li><li>loadDate: 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, EXISTS, NOT_EXISTS.</li><li>groupId: a String value should be a UUID of an existing group. Allowed operator: EQUALS. </li><li>label: a String up to 100 characters. Allowed operator: CONTAINS. </li></ul>The orderByAttribute supports these attribute names: serialNumber, state, loadDate or lastUsedDate.Sorting by attributes containing Null values such as lastUsedDate is not possible. Therefore, any record containing Null in the orderByAttribute will be filtered out before doing the sorting.](/api/openapi/admin-api/assigned-token-page-using-post.md)

[📄️Lists a page of unassigned hardware tokens Returns unassigned hardware tokens for the provided search parameters. Caller requires the TOKENS:VIEW permission.The following searchByAttributes are supported: <ul><li>serialNumber: a String up to 100 characters. Allowed operators are: EQUALS, CONTAINS, STARTS_WITH.</li><li>type: OATH_PHYSICAL_TOKEN or ENTRUST_LEGACY_TOKEN. Allowed operator: EQUALS.</li><li>loadDate: 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>The orderByAttribute supports these attribute names: serialNumber.](/api/openapi/admin-api/unassigned-token-page-using-post.md)

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

[📄️Create a token Create a token of the given type for the given user. Caller requires the TOKENS:ADD permission.](/api/openapi/admin-api/create-token-using-post.md)