{ "info": { "_postman_id": "3172aa61-0663-59c9-b925-ee128b4d3137", "name": "Next Task REST API (docs v6)", "description": "Lists and tasks over Joomla's Web Services application, authenticated with Joomla's\nstandard API token. A call acts as the token's user: it sees and changes exactly what\nthat user can in the app, and what their roles allow applies here too.\n\nEvery answer from Next Task is JSON in the same envelope, `success`, `data` and\n`message`, with a real HTTP status. Due dates are written in the site's time zone,\nwithout a zone suffix.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "baseUrl", "value": "https://your-site.example/api/index.php", "type": "string" }, { "key": "apiToken", "value": "", "type": "string" } ], "item": [ { "name": "Lists", "item": [ { "name": "GET List Lists", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists" ] }, "description": "List your lists\n\nYour own lists and the lists shared with you." }, "response": [ { "name": "200 The lists.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists" ] }, "description": "List your lists\n\nYour own lists and the lists shared with you." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"items\": [\n {\n \"id\": 5,\n \"user_id\": 1,\n \"title\": \"Groceries\",\n \"color\": \"#1967d2\",\n \"position\": \"string\",\n \"is_default\": 1,\n \"is_team\": 1,\n \"owner_name\": \"string\",\n \"access\": \"owner\",\n \"can_leave\": true,\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ]\n }\n}" } ] }, { "name": "POST Create List", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists" ] }, "description": "Create a list\n\nNeeds **Lists > Create**.", "body": { "mode": "raw", "raw": "{\n \"title\": \"Groceries\",\n \"color\": \"#1967d2\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The list.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists" ] }, "description": "Create a list\n\nNeeds **Lists > Create**.", "body": { "mode": "raw", "raw": "{\n \"title\": \"Groceries\",\n \"color\": \"#1967d2\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 5,\n \"user_id\": 1,\n \"title\": \"Groceries\",\n \"color\": \"#1967d2\",\n \"position\": \"string\",\n \"is_default\": 1,\n \"is_team\": 1,\n \"owner_name\": \"string\",\n \"access\": \"owner\",\n \"can_leave\": true,\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "GET Get List", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Get a list\n\nOne list you can reach." }, "response": [ { "name": "200 The list.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Get a list\n\nOne list you can reach." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 5,\n \"user_id\": 1,\n \"title\": \"Groceries\",\n \"color\": \"#1967d2\",\n \"position\": \"string\",\n \"is_default\": 1,\n \"is_team\": 1,\n \"owner_name\": \"string\",\n \"access\": \"owner\",\n \"can_leave\": true,\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "PATCH Update List", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Change a list\n\nChanges only the fields sent. Needs **Lists > Edit**, on a list you own.", "body": { "mode": "raw", "raw": "{\n \"title\": \"Weekly groceries\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The list.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Change a list\n\nChanges only the fields sent. Needs **Lists > Edit**, on a list you own.", "body": { "mode": "raw", "raw": "{\n \"title\": \"Weekly groceries\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 5,\n \"user_id\": 1,\n \"title\": \"Groceries\",\n \"color\": \"#1967d2\",\n \"position\": \"string\",\n \"is_default\": 1,\n \"is_team\": 1,\n \"owner_name\": \"string\",\n \"access\": \"owner\",\n \"can_leave\": true,\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "DELETE Delete List", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Delete a list\n\nDeletes a list you own and its tasks. Needs **Lists > Delete**. A default list cannot be deleted." }, "response": [ { "name": "200 The ids deleted.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Delete a list\n\nDeletes a list you own and its tasks. Needs **Lists > Delete**. A default list cannot be deleted." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"deleted\": [\n 1\n ]\n }\n}" } ] }, { "name": "GET Get List Members", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id", "members" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "List a list's members\n\nEveryone who can reach the list, which is who its tasks can be assigned to." }, "response": [ { "name": "200 The members.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/lists/:id/members", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "lists", ":id", "members" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "List a list's members\n\nEveryone who can reach the list, which is who its tasks can be assigned to." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"items\": [\n {\n \"id\": 7,\n \"name\": \"Maria Lopez\",\n \"username\": \"maria\",\n \"access\": \"owner\"\n }\n ]\n }\n}" } ] } ] }, { "name": "Tasks", "item": [ { "name": "GET List Tasks", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks?", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks" ], "query": [ { "key": "list_id", "value": "", "disabled": true }, { "key": "view", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "due_from", "value": "", "disabled": true }, { "key": "due_to", "value": "", "disabled": true }, { "key": "parent_id", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "offset", "value": "", "disabled": true } ] }, "description": "List tasks\n\nTasks you can reach, narrowed by the filters." }, "response": [ { "name": "200 The tasks.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks?", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks" ], "query": [ { "key": "list_id", "value": "", "disabled": true }, { "key": "view", "value": "", "disabled": true }, { "key": "search", "value": "", "disabled": true }, { "key": "due_from", "value": "", "disabled": true }, { "key": "due_to", "value": "", "disabled": true }, { "key": "parent_id", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "offset", "value": "", "disabled": true } ] }, "description": "List tasks\n\nTasks you can reach, narrowed by the filters." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"items\": [\n {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ]\n }\n}" } ] }, { "name": "POST Create Task", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks" ] }, "description": "Create a task\n\nNeeds **Tasks > Create** and edit access to the list. Send `parent_id` to create a subtask.", "body": { "mode": "raw", "raw": "{\n \"title\": \"Ship it\",\n \"list_id\": 5,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The task.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks" ] }, "description": "Create a task\n\nNeeds **Tasks > Create** and edit access to the list. Send `parent_id` to create a subtask.", "body": { "mode": "raw", "raw": "{\n \"title\": \"Ship it\",\n \"list_id\": 5,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "POST Bulk Tasks", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", "bulk" ] }, "description": "Change several tasks\n\nRuns each change as its single-task call, with the same checks.", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n 3,\n 4\n ],\n \"action\": \"complete\"\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The action, the tasks it changed and any next occurrences it created.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/bulk", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", "bulk" ] }, "description": "Change several tasks\n\nRuns each change as its single-task call, with the same checks.", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n 3,\n 4\n ],\n \"action\": \"complete\"\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"action\": \"string\",\n \"ids\": [\n 1\n ],\n \"items\": [\n {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ],\n \"clones\": [\n {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ]\n }\n}" } ] }, { "name": "POST Star Tasks", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/star", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", "star" ] }, "description": "Star several tasks\n\nStars the tasks, or unstars them with `starred` false. Answers as the bulk call does.", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n 3,\n 4\n ],\n \"starred\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The action, the tasks it changed and any next occurrences it created.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/star", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", "star" ] }, "description": "Star several tasks\n\nStars the tasks, or unstars them with `starred` false. Answers as the bulk call does.", "body": { "mode": "raw", "raw": "{\n \"ids\": [\n 3,\n 4\n ],\n \"starred\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"action\": \"string\",\n \"ids\": [\n 1\n ],\n \"items\": [\n {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ],\n \"clones\": [\n {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ]\n }\n}" } ] }, { "name": "GET Get Task", "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Get a task\n\nOne task you can reach." }, "response": [ { "name": "200 The task.", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Get a task\n\nOne task you can reach." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "PATCH Update Task", "request": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Change a task\n\nChanges only the fields sent. Needs **Tasks > Edit** and edit access to its list.", "body": { "mode": "raw", "raw": "{\n \"notes\": \"Call before noon\",\n \"starred\": 1\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The task.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Change a task\n\nChanges only the fields sent. Needs **Tasks > Edit** and edit access to its list.", "body": { "mode": "raw", "raw": "{\n \"notes\": \"Call before noon\",\n \"starred\": 1\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "DELETE Delete Task", "request": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Delete a task\n\nDeletes a task and its subtasks. It can be restored for 7 days. Needs **Tasks > Delete**." }, "response": [ { "name": "200 The ids deleted.", "originalRequest": { "method": "DELETE", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Delete a task\n\nDeletes a task and its subtasks. It can be restored for 7 days. Needs **Tasks > Delete**." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"deleted\": [\n 1\n ]\n }\n}" } ] }, { "name": "POST Complete Task", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id/complete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id", "complete" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Complete or reopen a task\n\n`completed` true completes the task, and a repeating task gets its next occurrence.\nFalse reopens it. Needs **Tasks > Complete**.", "body": { "mode": "raw", "raw": "{\n \"completed\": true\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The task, and the next occurrence if one was created.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id/complete", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id", "complete" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Complete or reopen a task\n\n`completed` true completes the task, and a repeating task gets its next occurrence.\nFalse reopens it. Needs **Tasks > Complete**.", "body": { "mode": "raw", "raw": "{\n \"completed\": true\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"task\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n },\n \"item\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n },\n \"clone\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n },\n \"removed_clone_id\": 1\n }\n}" } ] }, { "name": "POST Move Task", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id/move", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id", "move" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Move a task\n\nTo another list, next to another task, or under or out of a parent. Needs **Tasks > Edit**.", "body": { "mode": "raw", "raw": "{\n \"list_id\": 6\n}", "options": { "raw": { "language": "json" } } } }, "response": [ { "name": "200 The task.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" }, { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id/move", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id", "move" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Move a task\n\nTo another list, next to another task, or under or out of a parent. Needs **Tasks > Edit**.", "body": { "mode": "raw", "raw": "{\n \"list_id\": 6\n}", "options": { "raw": { "language": "json" } } } }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"item\": {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n }\n}" } ] }, { "name": "POST Restore Task", "request": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id/restore", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id", "restore" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Restore a deleted task\n\nUndoes a delete within 7 days. Needs **Tasks > Delete**." }, "response": [ { "name": "200 What came back.", "originalRequest": { "method": "POST", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v1/nexttask/tasks/:id/restore", "host": [ "{{baseUrl}}" ], "path": [ "v1", "nexttask", "tasks", ":id", "restore" ], "variable": [ { "key": "id", "description": "The record the call is about. An `id` or `ids` in the body is ignored." } ] }, "description": "Restore a deleted task\n\nUndoes a delete within 7 days. Needs **Tasks > Delete**." }, "status": "200", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"success\": true,\n \"message\": \"string\",\n \"messages\": \"string\",\n \"data\": {\n \"restored\": [\n 1\n ],\n \"items\": [\n {\n \"id\": 12,\n \"list_id\": 5,\n \"parent_id\": 0,\n \"title\": \"Ship it\",\n \"notes\": \"string\",\n \"status\": \"needsAction\",\n \"starred\": 1,\n \"due\": \"2026-10-02 09:00:00\",\n \"has_time\": 1,\n \"recurrence\": \"string\",\n \"recurrence_next_id\": 1,\n \"completed_time\": \"string\",\n \"position\": \"string\",\n \"links\": [\n {}\n ],\n \"assigned_to\": 1,\n \"assignee_name\": \"string\",\n \"subtask_count\": 1,\n \"completed_subtask_count\": 1,\n \"access\": \"owner\",\n \"can_complete\": true,\n \"deleted_time\": \"string\",\n \"created\": \"string\",\n \"created_by\": 1,\n \"modified\": \"string\",\n \"modified_by\": 1\n }\n ]\n }\n}" } ] } ] } ], "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "X-Joomla-Token", "type": "string" }, { "key": "value", "value": "{{apiToken}}", "type": "string" }, { "key": "in", "value": "header", "type": "string" } ] } }