​
POST a task

POST /user-api/v1/tasks

​
Headers

HeaderValue
Content-Typeapplication/json
x-rolodex-api-keyf1e2d3c4b5a697...

​
Required Fields

​
body
string
Task description (minimum 1 character)
​
due_date
string
Due date in ISO datetime format

​
Optional Fields

​
completed_at
string
Completion date in ISO datetime format

​
Request

{
  "body": "Prepare quarterly business review presentation",
  "due_date": "2025-01-25T16:00:00Z",
  "assignee": "user_456",
  "creator": "user_789",
  "contacts": [
    "contact_123",
    {
      "id": "contact_456"
    }
  ],
  "tags": [
    "tag_101",
    {
      "id": "tag_102"
    }
  ]
}

​
Response

{
  "data": {
    "id": "task_99999",
    "body": "Prepare quarterly business review presentation",
    "due_date": "2025-01-25T16:00:00Z",
    "completed_at": null,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z",
    "contacts": [
      {
        "id": "contact_123",
        "full_name": "John Doe",
        "image_url": "https://example.com/avatar1.jpg"
      },
      {
        "id": "contact_456",
        "full_name": "Jane Smith",
        "image_url": "https://example.com/avatar2.jpg"
      }
    ],
    "assignee": {
      "id": "user_456",
      "full_name": "Alice Smith",
      "avatar_url": "https://example.com/user-avatar.jpg"
    },
    "creator": {
      "id": "user_789",
      "full_name": "Bob Johnson",
      "avatar_url": "https://example.com/creator-avatar.jpg"
    },
    "tags": [
      {
        "id": "tag_101",
        "name": "High Priority"
      },
      {
        "id": "tag_102",
        "name": "Sales"
      }
    ]
  }
}