# API token

An API token allows access to our API. It is linked to a Role, which describes what actions can be performed.

## Object payload

id string

ID of access\_token

Example: `"312"`

type string

Must be exactly `"access_token"`.

name string

Name of API token

Example: `"Read-only API token"`

hardcoded\_type null, string

can\_access\_cda boolean

Whether this API token can access the Content Delivery API published content endpoint

can\_access\_cda\_preview boolean

Whether this API token can access the Content Delivery API draft content endpoint

can\_access\_cma boolean

Whether this API token can access the Content Management API

last\_cma\_access enum

When this API token was last used to access the Content Management API

Example: `"never"`

Show enum values

today

Today

yesterday

Yesterday

this\_week

This week (Monday-Sunday)

last\_week

Last week (Monday-Sunday)

this\_month

This calendar month

last\_month

Last calendar month

never

No recent usage (beyond last month)

last\_cda\_access enum

When this API token was last used to access the Content Delivery API

Example: `"never"`

Show enum values

today

Today

yesterday

Yesterday

this\_week

This week (Monday-Sunday)

last\_week

Last week (Monday-Sunday)

this\_month

This calendar month

last\_month

Last calendar month

never

No recent usage (beyond last month)

token null, string

The actual API token (or null if the current user has no permission to read the token)

Example: `"XXXXXXXXXXXXXXX"`

role

Role

Type: [ResourceLinkage<"role"\>](https://www.datocms.com/docs/content-management-api/resources/role.md), null

## Available endpoints

-   [Create a new API token](https://www.datocms.com/docs/content-management-api/resources/access-token/create.md)

-   [Update an API token](https://www.datocms.com/docs/content-management-api/resources/access-token/update.md)
-   [List all API tokens](https://www.datocms.com/docs/content-management-api/resources/access-token/instances.md)

-   [Retrieve an API token](https://www.datocms.com/docs/content-management-api/resources/access-token/self.md)
-   [Rotate API token](https://www.datocms.com/docs/content-management-api/resources/access-token/regenerate_token.md)

-   [Delete an API token](https://www.datocms.com/docs/content-management-api/resources/access-token/destroy.md)

## Related content in "Content Management API"

- [Content Management API Overview](https://www.datocms.com/docs/content-management-api.md)

- [Using the JavaScript CMA client](https://www.datocms.com/docs/content-management-api/using-the-nodejs-clients.md)
- [API versioning](https://www.datocms.com/docs/content-management-api/api-versioning.md)

- [Authentication](https://www.datocms.com/docs/content-management-api/authentication.md)
- [Environments](https://www.datocms.com/docs/content-management-api/setting-the-environment.md)

- [Error codes & handling failures (CMA)](https://www.datocms.com/docs/content-management-api/errors.md)
- [Pagination](https://www.datocms.com/docs/content-management-api/pagination.md)

- [Asynchronous jobs](https://www.datocms.com/docs/content-management-api/async-jobs.md)
- [Technical Limits (CMA)](https://www.datocms.com/docs/content-management-api/technical-limits.md)

- [Record](https://www.datocms.com/docs/content-management-api/resources/item.md)
- [Scheduled publication](https://www.datocms.com/docs/content-management-api/resources/scheduled-publication.md)

- [Scheduled unpublishing](https://www.datocms.com/docs/content-management-api/resources/scheduled-unpublishing.md)
- [Upload](https://www.datocms.com/docs/content-management-api/resources/upload.md)

- [Site](https://www.datocms.com/docs/content-management-api/resources/site.md)
- [Model/Block model](https://www.datocms.com/docs/content-management-api/resources/item-type.md)

- [Field](https://www.datocms.com/docs/content-management-api/resources/field.md)
- [Fieldset](https://www.datocms.com/docs/content-management-api/resources/fieldset.md)

- [Record version](https://www.datocms.com/docs/content-management-api/resources/item-version.md)
- [Upload permission](https://www.datocms.com/docs/content-management-api/resources/upload-request.md)

- [Upload track](https://www.datocms.com/docs/content-management-api/resources/upload-track.md)
- [Manual tags](https://www.datocms.com/docs/content-management-api/resources/upload-tag.md)

- [Smart tags](https://www.datocms.com/docs/content-management-api/resources/upload-smart-tag.md)
- [Upload Collection](https://www.datocms.com/docs/content-management-api/resources/upload-collection.md)

- [Search Index](https://www.datocms.com/docs/content-management-api/resources/search-index.md)
- [Search result](https://www.datocms.com/docs/content-management-api/resources/search-result.md)

- [Search indexing activity](https://www.datocms.com/docs/content-management-api/resources/search-index-event.md)
- [Environment](https://www.datocms.com/docs/content-management-api/resources/environment.md)

- [Maintenance mode](https://www.datocms.com/docs/content-management-api/resources/maintenance-mode.md)
- [Menu Item](https://www.datocms.com/docs/content-management-api/resources/menu-item.md)

- [Schema Menu Item](https://www.datocms.com/docs/content-management-api/resources/schema-menu-item.md)
- [Uploads filter](https://www.datocms.com/docs/content-management-api/resources/upload-filter.md)

- [Model filter](https://www.datocms.com/docs/content-management-api/resources/item-type-filter.md)
- [Plugin](https://www.datocms.com/docs/content-management-api/resources/plugin.md)

- [Workflow](https://www.datocms.com/docs/content-management-api/resources/workflow.md)
- [Asynchronous job](https://www.datocms.com/docs/content-management-api/resources/job.md)

- [Job result](https://www.datocms.com/docs/content-management-api/resources/job-result.md)
- [Account](https://www.datocms.com/docs/content-management-api/resources/account.md)

- [Organization](https://www.datocms.com/docs/content-management-api/resources/organization.md)
- [Invitation](https://www.datocms.com/docs/content-management-api/resources/site-invitation.md)

- [Collaborator](https://www.datocms.com/docs/content-management-api/resources/user.md)
- [Role](https://www.datocms.com/docs/content-management-api/resources/role.md)

- [API token](https://www.datocms.com/docs/content-management-api/resources/access-token.md)
- [Create a new API token](https://www.datocms.com/docs/content-management-api/resources/access-token/create.md)

- [Update an API token](https://www.datocms.com/docs/content-management-api/resources/access-token/update.md)
- [List all API tokens](https://www.datocms.com/docs/content-management-api/resources/access-token/instances.md)

- [Retrieve an API token](https://www.datocms.com/docs/content-management-api/resources/access-token/self.md)
- [Rotate API token](https://www.datocms.com/docs/content-management-api/resources/access-token/regenerate_token.md)

- [Delete an API token](https://www.datocms.com/docs/content-management-api/resources/access-token/destroy.md)
- [Webhook](https://www.datocms.com/docs/content-management-api/resources/webhook.md)

- [Webhook call](https://www.datocms.com/docs/content-management-api/resources/webhook-call.md)
- [Build trigger](https://www.datocms.com/docs/content-management-api/resources/build-trigger.md)

- [Deploy activity](https://www.datocms.com/docs/content-management-api/resources/build-event.md)
- [Subscription limit](https://www.datocms.com/docs/content-management-api/resources/subscription-limit.md)

- [Subscription feature](https://www.datocms.com/docs/content-management-api/resources/subscription-feature.md)
- [SSO Settings](https://www.datocms.com/docs/content-management-api/resources/sso-settings.md)

- [SSO User](https://www.datocms.com/docs/content-management-api/resources/sso-user.md)
- [SSO Group](https://www.datocms.com/docs/content-management-api/resources/sso-group.md)

- [White-label settings](https://www.datocms.com/docs/content-management-api/resources/white-label-settings.md)
- [Audit log event](https://www.datocms.com/docs/content-management-api/resources/audit-log-event.md)