Projects

List projects

GET /api/v1/projects

Parameters

Name	In	Type	Required	Description
`status`	query	string (active, paused, done, backlog, cancelled)	No	—
`containerId`	query	string	No	—

Example request

curl -X GET \
"https://api.usemonoid.com/api/v1/projects?status=<status>&containerId=<containerId>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": [
    {
      "_id": "string",
      "userId": "string",
      "title": "string",
      "description": "string",
      "status": "active",
      "containerId": "string",
      "updatedAt": 0
    }
  ]
}

Other statuses: 401, 403.

Response body type

{ data: Project[] }

Create project

POST /api/v1/projects

Example request

curl -X POST \
"https://api.usemonoid.com/api/v1/projects" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"
-d '{"title":"string","description":"string","status":"active","containerId":"string"}'

Example response

Status: 201

{
  "data": {
    "_id": "string",
    "userId": "string",
    "title": "string",
    "description": "string",
    "status": "active",
    "containerId": "string",
    "updatedAt": 0
  }
}

Other statuses: 400, 401, 403, 500.

Response body type

{ data: Project }

Get project by id

GET /api/v1/projects/{id}

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Path parameter.

Example request

curl -X GET \
"https://api.usemonoid.com/api/v1/projects/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Example response

Status: 200

{
  "data": {
    "_id": "string",
    "userId": "string",
    "title": "string",
    "description": "string",
    "status": "active",
    "containerId": "string",
    "updatedAt": 0
  }
}

Other statuses: 401, 403, 404.

Response body type

{ data: Project }

Update project

PATCH /api/v1/projects/{id}

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Path parameter.

Example request

curl -X PATCH \
"https://api.usemonoid.com/api/v1/projects/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"
-d '{"title":"string","description":"string","status":"active","containerId":"string"}'

Example response

Status: 200

{
  "data": {
    "_id": "string",
    "userId": "string",
    "title": "string",
    "description": "string",
    "status": "active",
    "containerId": "string",
    "updatedAt": 0
  }
}

Other statuses: 400, 401, 403, 404, 500.

Response body type

{ data: Project }

Delete project

DELETE /api/v1/projects/{id}

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	Path parameter.

Example request

curl -X DELETE \
"https://api.usemonoid.com/api/v1/projects/<id>" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json"

Other statuses: 401, 403, 404, 500.

Response body type

—

App Integrations

Projects