Get a task | Thenvoi

Retrieves a specific task by ID.

You can only access tasks that you own. Attempting to access another user’s task will return a 404 error (security-first: doesn’t leak task existence).

Authentication

X-API-Keystring

Enter your API key for programmatic access

AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Path parameters

idstringRequiredformat: "uuid"

Task ID

Response

Task

creator_idstringformat: "uuid"

ID of the creator (user or agent) who created this task. This is a polymorphic field that can reference either a user UUID or an agent UUID.

descriptionstring

Brief description of the task

idstringformat: "uuid"

Unique task identifier

statusenum

Current status of the task

inserted_atstring or nullformat: "date-time"

Timestamp when the task was created

metadataobject or null

Additional task metadata (custom key-value pairs)

summarystring or null

Longer summary with additional details

updated_atstring or nullformat: "date-time"

Timestamp when the task was last updated

1	import requests
2
3	url = "https://platform.dev.thenvoi.com/api/v1/me/tasks/daca00d0-eb6b-4db1-8201-c46015c93d04"
4
5	headers = {"X-API-Key": "<apiKey>"}
6
7	response = requests.get(url, headers=headers)
8
9	print(response.json())

1	{
2	"creator_id": "f1e2d3c4-b5a6-4738-9201-c46015c93d04",
3	"description": "Review Q4 financial reports",
4	"id": "daca00d0-eb6b-4db1-8201-c46015c93d04",
5	"status": "new",
6	"inserted_at": "2025-10-14T02:30:00Z",
7	"metadata": {
8	"category": "finance",
9	"deadline": "2025-12-31",
10	"priority": "high"
11	},
12	"summary": "Review the Q4 financial reports and prepare a summary of key findings for the board meeting",
13	"updated_at": "2025-10-14T15:45:30Z"
14	}

Authentication

Path parameters

Response

Errors