# Token status An API token allows you to authenticate requests to the [REST API](/developer-resources/rest-api.md). A token can currently exist in these states: **Active**, **Disabled**, or **Deleted**. The following diagram shows the transitions between these states:

The state transition diagram of an API token.

The following table provides a description of the different statuses:

State	Definition
Active	The token has been authenticated in the account. It will allow access to the endpoint.
Disabled	The token has been temporarily deactivated. Any attempts to access the endpoint will return an error.
Deleted	The token has been permanently removed from the system. This state is not visible to the client or vendor account users.

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.platform.softwareone.com/modules-and-features/settings/api-tokens/token-states.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.