Sorry, no results found for "".

Show examples in:
Javascript HTTP
Endpoint info
Available examples

Content Management API > API token

Create a new API token

Body parameters

type string Required

Must be exactly "access_token".

attributes.name string Required

Name of API token

Example: "Read-only API token"
attributes.can_access_cda boolean Required

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

attributes.can_access_cda_preview boolean Required

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

attributes.can_access_cma boolean Required

Whether this API token can access the Content Management API

relationships.role.data Required

Role

Returns

Returns a resource object of type access_token.

Examples

POST https://site-api.datocms.com/access_tokens HTTP/1.1
Authorization: Bearer YOUR-API-TOKEN
Accept: application/json
X-Api-Version: 3
Content-Type: application/vnd.api+json
{
"data": {
"type": "access_token",
"attributes": {
"name": "Read-only API token",
"can_access_cda": true,
"can_access_cda_preview": true,
"can_access_cma": true
},
"relationships": {
"role": {
"data": {
"type": "role",
"id": "34"
}
}
}
}
}
Terminal window
curl -g 'https://site-api.datocms.com/access_tokens' \
-X POST \
-H "Authorization: Bearer YOUR-API-TOKEN" \
-H "Accept: application/json" \
-H "X-Api-Version: 3" \
-H "Content-Type: application/vnd.api+json" \
--data-binary '{"data":{"type":"access_token","attributes":{"name":"Read-only API token","can_access_cda":true,"can_access_cda_preview":true,"can_access_cma":true},"relationships":{"role":{"data":{"type":"role","id":"34"}}}}}'
await fetch("https://site-api.datocms.com/access_tokens", {
method: "POST",
headers: {
Authorization: "Bearer YOUR-API-TOKEN",
Accept: "application/json",
"X-Api-Version": "3",
"Content-Type": "application/vnd.api+json",
},
body: JSON.stringify({
data: {
type: "access_token",
attributes: {
name: "Read-only API token",
can_access_cda: true,
can_access_cda_preview: true,
can_access_cma: true,
},
relationships: { role: { data: { type: "role", id: "34" } } },
},
}),
});
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: cache-control: max-age=0, private, must-revalidate
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28
{
"data": {
"type": "access_token",
"id": "312",
"attributes": {
"name": "Read-only API token",
"hardcoded_type": "",
"can_access_cda": true,
"can_access_cda_preview": true,
"can_access_cma": true
},
"relationships": {
"role": {
"data": {
"type": "role",
"id": "34"
}
}
}
}
}