Projects

Browse the API reference and sample payloads for Time Magic integrations.

Projects

Projects group tasks and time entries.

List projects

Subscription required

Endpoint: /api/projects

Returns projects for the authenticated user.

Response body

{
  "projects": [
    {
      "id": "<project_uuid>",
      "name": "Client Work",
      "description": "Billable project"
    }
  ]
}

Get project

Subscription required

Endpoint: /api/projects/:id

Returns a project by UUID.

Response body

{
  "project": {
    "id": "<project_uuid>",
    "name": "Client Work",
    "description": "Billable project"
  }
}

Create project

Endpoint: /api/projects

Create a new project.

Request body

{
  "project": {
    "name": "Client Work",
    "description": "Billable project"
  }
}

Response body

{
  "project": {
    "id": "<project_uuid>",
    "name": "Client Work",
    "description": "Billable project"
  }
}

Update project

Endpoint: /api/projects/:id

Update a project.

Request body

{
  "project": {
    "name": "Client Work",
    "description": "Updated description"
  }
}

Response body

{
  "project": {
    "id": "<project_uuid>",
    "name": "Client Work",
    "description": "Updated description"
  }
}

Delete project

Endpoint: /api/projects/:id

Delete a project.

Response body

{
  "status": "deleted"
}