Skip to main content

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:

EventWhen
TASK_SHAREDA task is shared with the member
SHARE_ACCEPTEDThe member accepts
SHARE_DECLINEDThe member declines
SHARE_REVOKEDThe owner revokes the share
SHARED_TASK_COMPLETEDA 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​

StatusMeaning
400The request breaks a rule above, for example sharing a chore or a completed task
401Missing or invalid API key
403You're not the task's owner
404The task or member doesn't exist

The full schemas are in the API reference.