Create a task

POST

https://api.contentful.com/spaces/:space_id/environments/:environment_id/entries/:entry_id/tasks

POST

/spaces/:space_id/environments/:environment_id/entries/:entry_id/tasks

$ curl -X POST https://api.contentful.com/spaces/yadj1kx9rmg0/environments/staging/entries/5KsDBWseXY6QegucYAoacS/tasks \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/vnd.contentful.management.v1+json" \
>      -d '{
>   "body": "Review translation",
>   "status": "active",
>   "assignedTo": {
>     "sys": {
>       "type": "Link",
>       "linkType": "<User|Team>",
>       "id": "<assignee_id>"
>     }
>   }
> }'

201Entry tasks_createATask_example

1 {
2   "body": "Review translation",
3   "status": "active",
4   "assignedTo": {
5     "sys": {
6       "type": "Link",
7       "linkType": "<User|Team>",
8       "id": "<assignee_id>"
9     }
10   },
11   "sys": {
12     "id": "RHfHVRz3QkAgcMq4CGg2m5",
13     "type": "Task",
14     "parentEntity": {
15       "sys": {
16         "type": "Link",
17         "linkType": "Entry",
18         "id": "5KsDBWseXY6QegucYAoacS"
19       }
20     },
21     "version": 1,
22     "space": {
23       "sys": {
24         "type": "Link",
25         "linkType": "Space",
26         "id": "yadj1kx9rmg0"
27       }
28     },
29     "environment": {
30       "sys": {
31         "type": "Link",
32         "linkType": "Environment",
33         "id": "staging"
34       }
35     },
36     "createdAt": "2025-03-05T16:16:53.000Z",
37     "createdBy": {
38       "sys": {
39         "type": "Link",
40         "linkType": "User",
41         "id": "7BslKh9TdKGOK41VmLDjFZ"
42       }
43     },
44     "updatedAt": "2025-03-05T16:16:53.000Z",
45     "updatedBy": {
46       "sys": {
47         "type": "Link",
48         "linkType": "User",
49         "id": "4FLrUHftHW3v2BLi9fzfjU"
50       }
51     }
52   }
53 }

Creates a task on an entry with an auto-generated ID; limit is 100 tasks per entry. Email notifications are sent to the assignee (and team members if assigned to a team).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

space_idstringRequired

ID of the space in form of a string

environment_idstringRequired

ID of the environment in form of a string

entry_idstringRequired

ID of the entry in form of a string

Request

This endpoint expects a map from strings to any.

Response headers

Content-Typestring

Content-Type

Response

Created - Resource created successfully