Node.js
import { PeriskopeApi } from '@periskope/periskope-client';
const client = new PeriskopeApi({
authToken: 'YOUR_API_KEY',
});
async function getTask() {
const response = await client.task.getById({
task_id: 'task-00000000000000a1'
});
console.log(response);
}
getTask();curl https://api.periskope.app/v1/tasks/task-00000000000000a1 \
-H 'Authorization: Bearer <token>'{
"task_id": "task-elnizmojzrjsogdm",
"title": "Resolve customer escalation",
"type": "message",
"status": "closed",
"priority": 3,
"assignee": "ankit.singh@hashlabs.dev",
"created_by": "anjali.pandey@hashlabs.dev",
"last_updated_by": "ankit.singh@hashlabs.dev",
"created_at": "2026-06-03T06:00:56.592+00:00",
"last_updated_at": "2026-06-04T18:09:36.420636+00:00",
"due_date": "2026-06-15T18:00:00+00:00",
"remind_at": "2026-06-18T18:00:00+00:00",
"notes": "Customer escalated via email — coordinate with support",
"chat_id": "919205202401@c.us",
"association": {
"type": "message",
"message_id": "true_4ca42ab6-77a9-428d-b614-5eb37bcf8f95_anjali.pandey@hashlabs.dev",
"chat_id": "919205202401@c.us"
},
"completed_metadata": {
"completed_at": "2026-06-04T18:09:36.407Z",
"completed_by": "ankit.singh@hashlabs.dev"
}
}Task APIs
Get Task By ID
This endpoint retrieves a specific task id to get more info about the specific task
Node.js
import { PeriskopeApi } from '@periskope/periskope-client';
const client = new PeriskopeApi({
authToken: 'YOUR_API_KEY',
});
async function getTask() {
const response = await client.task.getById({
task_id: 'task-00000000000000a1'
});
console.log(response);
}
getTask();curl https://api.periskope.app/v1/tasks/task-00000000000000a1 \
-H 'Authorization: Bearer <token>'{
"task_id": "task-elnizmojzrjsogdm",
"title": "Resolve customer escalation",
"type": "message",
"status": "closed",
"priority": 3,
"assignee": "ankit.singh@hashlabs.dev",
"created_by": "anjali.pandey@hashlabs.dev",
"last_updated_by": "ankit.singh@hashlabs.dev",
"created_at": "2026-06-03T06:00:56.592+00:00",
"last_updated_at": "2026-06-04T18:09:36.420636+00:00",
"due_date": "2026-06-15T18:00:00+00:00",
"remind_at": "2026-06-18T18:00:00+00:00",
"notes": "Customer escalated via email — coordinate with support",
"chat_id": "919205202401@c.us",
"association": {
"type": "message",
"message_id": "true_4ca42ab6-77a9-428d-b614-5eb37bcf8f95_anjali.pandey@hashlabs.dev",
"chat_id": "919205202401@c.us"
},
"completed_metadata": {
"completed_at": "2026-06-04T18:09:36.407Z",
"completed_by": "ankit.singh@hashlabs.dev"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
- The unique identifier of the task
Example:
"task-elnizmojzrjsogdm"
Response
200 - application/json
200 OK
The response is a task object. Refer to the task object here
Was this page helpful?