My Developer PortalMy Developer Portal
  • Pricing
  • Documentation
  • API Reference
Information
Todo
    Get all todosgetCreate a new todopostUpdate a todoputDelete a tododelete
Other endpoints
    Generate threadspostValidate API key (free — connector connection tests)get
Schemas
powered by Zuplo
Todo API
Todo API

Todo

Endpoints for managing todo items including creating, listing, updating, and deleting tasks.


Get all todos

GET
https://social-swarm-main-aa77a19.zuplo.app
/todos

Retrieves a complete list of all todo items from the system. This endpoint returns all todos regardless of their completion status or owner, making it useful for displaying comprehensive todo lists or performing bulk operations.

Get all todos › Responses

200

A list of todos

​Todo[]
A complete todo item as returned by the API, including its system-assigned ID.
Todo
id
​integer · required

The todo ID

title
​string · required

The todo title

completed
​boolean · required

Whether the todo is completed

userId
​integer · required

The user ID who owns the todo

GET/todos
curl https://social-swarm-main-aa77a19.zuplo.app/todos
Example Responses
[ { "id": 1, "title": "Buy groceries", "completed": false, "userId": 123 }, { "id": 2, "title": "Write documentation", "completed": true, "userId": 456 }, { "id": 3, "title": "Review pull requests", "completed": false, "userId": 123 } ]
json
application/json

Create a new todo

POST
https://social-swarm-main-aa77a19.zuplo.app
/todos

Creates a new todo item with the provided details. The todo will be assigned a unique ID automatically and can include a title, completion status, and user association. This is the primary endpoint for adding new tasks to the system.

Create a new todo › Request Body

The request body for creating a new todo. Only a title and userId are required.
CreateTodo
title
​string · required

The todo title

userId
​integer · required

The user ID who owns the todo

completed
​boolean

Whether the todo is completed

Default: false

Create a new todo › Responses

Todo created successfully

A complete todo item as returned by the API, including its system-assigned ID.
Todo
id
​integer · required

The todo ID

title
​string · required

The todo title

completed
​boolean · required

Whether the todo is completed

userId
​integer · required

The user ID who owns the todo

POST/todos
curl https://social-swarm-main-aa77a19.zuplo.app/todos \ --request POST \ --header 'Content-Type: application/json' \ --data '{ "title": "title", "completed": false, "userId": 0 }'
Example Request Body
{ "title": "title", "completed": false, "userId": 0 }
json
Example Responses
{ "id": 4, "title": "Deploy application", "completed": false, "userId": 789 }
json
application/json

Update a todo

PUT
https://social-swarm-main-aa77a19.zuplo.app
/todos/{id}

Updates an existing todo item by its unique identifier. You can modify any combination of the todo's properties including title, completion status, and user assignment. All changes are applied atomically to ensure data consistency.

Update a todo › path Parameters

id
​integer · required

The todo ID

Update a todo › Request Body

The request body for updating a todo. All fields are optional so you can patch individual properties.
UpdateTodo
title
​string

The todo title

completed
​boolean

Whether the todo is completed

userId
​integer

The user ID who owns the todo

Update a todo › Responses

Todo updated successfully

A complete todo item as returned by the API, including its system-assigned ID.
Todo
id
​integer · required

The todo ID

title
​string · required

The todo title

completed
​boolean · required

Whether the todo is completed

userId
​integer · required

The user ID who owns the todo

PUT/todos/{id}
curl https://social-swarm-main-aa77a19.zuplo.app/todos/:id \ --request PUT \ --header 'Content-Type: application/json' \ --data '{ "title": "title", "completed": true, "userId": 0 }'
Example Request Body
{ "title": "title", "completed": true, "userId": 0 }
json
Example Responses
{ "id": 1, "title": "Buy groceries and cook dinner", "completed": true, "userId": 123 }
json
application/json

Delete a todo

DELETE
https://social-swarm-main-aa77a19.zuplo.app
/todos/{id}

Permanently removes a todo item from the system using its unique identifier. This operation cannot be undone, so use with caution. The endpoint will return a 404 error if the specified todo does not exist.

Delete a todo › path Parameters

id
​integer · required

The todo ID

Delete a todo › Responses

Todo deleted successfully

No data returned
DELETE/todos/{id}
curl https://social-swarm-main-aa77a19.zuplo.app/todos/:id \ --request DELETE
Example Responses
No example specified for this content type

Other endpoints