Projects
List all projects that the current user has access to.
1
Example: 1
Max number of projects to return
10
Example: 10
GET /projects/ HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"success": true,
"data": {
"items": [
{
"name": "text",
"description": "text",
"id": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2025-07-03T02:09:11.318Z",
"updated_at": "2025-07-03T02:09:11.318Z"
}
],
"pagination": {
"page": 1,
"limit": 1,
"total": 1,
"pages": 1
}
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
Create a new project and add the current user as an admin.
Model for creating a new project.
Project name
Project description
POST /projects/ HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 35
{
"name": "Ellen",
"description": null
}
{
"success": true,
"data": {
"name": "text",
"description": "text",
"id": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2025-07-03T02:09:11.318Z",
"updated_at": "2025-07-03T02:09:11.318Z"
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
Get detailed project information including members.
3f891542-df96-4ec6-9577-be733c628ea0
GET /projects/{project_id} HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"success": true,
"data": {
"name": "text",
"description": "text",
"id": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2025-07-03T02:09:11.318Z",
"updated_at": "2025-07-03T02:09:11.318Z",
"members": [
{
"user_id": "123e4567-e89b-12d3-a456-426614174000",
"email": "text",
"full_name": "text",
"role": "text"
}
]
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
Update project details (requires admin role).
Project ID to operate on
3f891542-df96-4ec6-9577-be733c628ea0
Model for updating a project.
Project name
Project description
PATCH /projects/{project_id} HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 97
{
"name": "Excepteur in reprehenderit officia-changed",
"description": "cillum tempor culpa-changed"
}
{
"success": true,
"data": {
"name": "text",
"description": "text",
"id": "123e4567-e89b-12d3-a456-426614174000",
"created_at": "2025-07-03T02:09:11.318Z",
"updated_at": "2025-07-03T02:09:11.318Z"
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
Add a user to the project (requires admin role).
Project ID to operate on
3f891542-df96-4ec6-9577-be733c628ea0
Model for adding a member to a project.
User ID to add to the project
Role in the project (admin, editor, viewer)
POST /projects/{project_id}/members HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 31
{
"user_id": "12",
"role": "admin"
}
{
"success": true,
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
Remove a user from the project (requires admin role).
f1d820e5-1f9b-4b41-a6a6-442121449420
Project ID to operate on
fc00f687-9030-40ad-8e4f-7f13586045f7
DELETE /projects/{project_id}/members/{user_id} HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"success": true,
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}
Update a member's role in the project (requires admin role).
f1d820e5-1f9b-4b41-a6a6-442121449420
Project ID to operate on
fc00f687-9030-40ad-8e4f-7f13586045f7
Model for updating a member's role in a project.
Role in the project (admin, editor, viewer)
PATCH /projects/{project_id}/members/{user_id} HTTP/1.1
Host: localhost:8000
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 16
{
"role": "admin"
}
{
"success": true,
"data": {
"ANY_ADDITIONAL_PROPERTY": "anything"
},
"error": {
"ANY_ADDITIONAL_PROPERTY": "anything"
}
}