REST API
DuckTape's REST API allows developers to programmatically access its features. Alternatively, you can use the DuckTape command line or natural language commands for quick interactions.
Base URL
All API requests are made to the following base URL:
https://api.ducktapeai.com/v1Authentication
All requests require an API key for authentication. Include the API key in the Authorization header:
curl -X GET https://api.ducktapeai.com/v1/reminders \
-H "Authorization: Bearer YOUR_API_KEY"Endpoints
Reminders
Manage reminders using the following endpoints:
| Method | Endpoint | Description |
|---|---|---|
GET |
/reminders |
Retrieve a list of reminders |
POST |
/reminders |
Create a new reminder |
GET |
/reminders/{id} |
Retrieve a specific reminder |
PUT |
/reminders/{id} |
Update a reminder |
DELETE |
/reminders/{id} |
Delete a reminder |
Notes
Manage notes using the following endpoints:
| Method | Endpoint | Description |
|---|---|---|
GET |
/notes |
Retrieve a list of notes |
POST |
/notes |
Create a new note |
GET |
/notes/{id} |
Retrieve a specific note |
PUT |
/notes/{id} |
Update a note |
DELETE |
/notes/{id} |
Delete a note |
Error Handling
The API returns standard HTTP status codes to indicate the success or failure of a request:
| Status Code | Description |
|---|---|
200 OK |
Request was successful |
400 Bad Request |
Invalid request parameters |
401 Unauthorized |
Missing or invalid API key |
403 Forbidden |
Insufficient permissions |
404 Not Found |
Resource not found |
429 Too Many Requests |
Rate limit exceeded |
500 Internal Server Error |
Server encountered an error |