Tasks

Create a task

post/tasks

Request

Base URL
https://gorest.co.in/public/v3
URL
https://gorest.co.in/public/v3/tasks
Auth
HTTP bearer

Headers

Idempotency-Keystring

A unique key (a UUID is fine) that makes a POST safe to retry for 24 hours. A retry with the same key, path and body gets the first answer again with Idempotent-Replayed: true and creates nothing; a retry while the first is still running gets 409 conflict with Retry-After: 1. The same key with another request gets 422 idempotency_key_mismatch. Only a 2xx answer is kept, so after an error the retry runs again. An answer over 64 KiB, or one that holds a new token's value, is not kept: its retry gets 409 conflict with the Location of what the first request made.

Request body

descriptionstring

due_onstring date nullable

priority'low' | 'medium' | 'high' | 'urgent'

status'todo' | 'in_progress' | 'done'

titlestring required

Not blank; spaces at the ends are dropped.

user_idstring uuid nullable

A user you can see.

Response

The new task.

created_atstring date-time

descriptionstring

due_onstring date nullable

idstring uuid required

priority'low' | 'medium' | 'high' | 'urgent'

read_onlyboolean

True for sample data (the seed); it cannot be changed.

status'todo' | 'in_progress' | 'done'

titlestring

updated_atstring date-time

user_idstring uuid nullable

Who the task is for; null when nobody.

Example response

{
  "due_on": "2026-11-15",
  "title": "Add paging to the orders list",
  "user": {
    "email": "aarav.sharma@example.com",
    "name": "Aarav Sharma"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.