Get a task

Get the details of an existing task.

Request

GET https://superinterface.ai/api/cloud/tasks/{taskId}

Path Parameters

ParameterTypeDescription
taskIdstringThe ID of an existing task

Authentication

Include your private API key in the request headers:
Authorization: Bearer YOUR_PRIVATE_API_KEY

Example request

curl -X GET "https://superinterface.ai/api/cloud/tasks/70cfe680-fee5-49b9-b386-6a7097eb8497" \ -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \ -H "Content-Type: application/json"

Response

ParameterTypeDescription
taskTaskExisting task

Example response

{ "task": { "id": "70cfe680-fee5-49b9-b386-6a7097eb8497", "title": "Send reminder", "message": "Check in with the user", "schedule": { "start": "2025-07-01T09:00:00", "timeZone": "America/New_York", "recurrenceRules": [ { "frequency": "daily" } ] }, "threadId": "60cfe680-fee5-49b9-b386-6a7097eb8497", "key": "", "createdAt": "2025-07-01T09:00:00Z", "updatedAt": "2025-07-01T09:00:00Z" } }

Errors

The endpoint may return the following errors:

401 Unauthorized

This error occurs if the API key is invalid or missing.
{ "error": "Unauthorized", "message": "Invalid or missing API key" }