Task sharing for developers
This page covers the task sharing endpoints of the Mind Your Now API. A task owner can share a task with members of their household; the member accepts or declines, and the owner can revoke the share later. For how sharing looks in the app, see Task sharing.
Authentication
Send an API key with Full Agent Access in the X-API-KEY header. See API for how to create one.
curl -H "X-API-KEY: YOUR_API_KEY" \
"https://api.mindyournow.com/api/v2/unified-tasks/shared-with-me"
Rules
- Only the task's owner can share it, and only with members of a household the owner belongs to.
- You can't share chores, habits, archived or completed tasks, or recurring tasks, and you can't share a task with yourself.
- Share types:
VIEW: the member can see the task.EDIT: the member can see and change it.DELEGATE: ownership passes to the member.
Endpoints
All paths are under https://api.mindyournow.com/api/v2. Bodies and responses use snake_case field names.
Share a task
POST /unified-tasks/{taskId}/share
{
"member_ids": ["550e8400-e29b-41d4-a716-446655440001"],
"share_type": "EDIT",
"message": "Can you take this one?"
}
message is optional. The response describes the new share, with status set to PENDING. When you share with several members at once, it describes the first share and its message says how many were created.
{
"assignment_id": 123,
"task_id": "task-uuid-123",
"task_title": "Book the plumber",
"shared_with_member_id": "550e8400-e29b-41d4-a716-446655440001",
"share_type": "EDIT",
"status": "PENDING",
"message": "Can you take this one?"
}
List tasks shared with you
GET /unified-tasks/shared-with-me
Returns pending_shares (waiting for an answer), accepted_shares and total_count.
Accept or decline
POST /unified-tasks/{taskId}/share/respond
{
"response": "ACCEPT",
"note": "On it"
}
response is ACCEPT or DECLINE; note is optional. Accepting returns the updated share. Declining returns 200 with an empty body.
See who a task is shared with
GET /unified-tasks/{taskId}/shares
Returns every share on the task. Only the owner may call it; anyone else gets 403.
Revoke a share
DELETE /unified-tasks/{taskId}/share/{memberId}
Returns 204 on success.
Notifications
Each sharing event is saved to the recipient's notification inbox and sent to their devices as a push notification. The events are:
| Event | When |
|---|---|
TASK_SHARED | A task is shared with the member |
SHARE_ACCEPTED | The member accepts |
SHARE_DECLINED | The member declines |
SHARE_REVOKED | The owner revokes the share |
SHARED_TASK_COMPLETED | A member finishes a shared task |
An integration that uses an API key should read the inbox with GET /api/v2/notifications (or GET /api/v2/notifications/unread), or check shared-with-me again. The Mind Your Now apps also receive these events live over their own signed-in connection.
Errors
| Status | Meaning |
|---|---|
400 | The request breaks a rule above, for example sharing a chore or a completed task |
401 | Missing or invalid API key |
403 | You're not the task's owner |
404 | The task or member doesn't exist |
The full schemas are in the API reference.