> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pinkfish.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# clientary-projects

> Projects, Hours, Expenses

**Server path:** `/clientary-projects` | **Type:** Application | **PCID required:** Yes

## Tools

| Tool                                                                              | Description              |
| --------------------------------------------------------------------------------- | ------------------------ |
| [`clientary_projects_create_expense`](#clientary_projects_create_expense)         | Create an expense        |
| [`clientary_projects_create_hour_entry`](#clientary_projects_create_hour_entry)   | Create a time entry      |
| [`clientary_projects_create_project`](#clientary_projects_create_project)         | Create a new project     |
| [`clientary_projects_delete_expense`](#clientary_projects_delete_expense)         | Delete an expense        |
| [`clientary_projects_delete_hour_entry`](#clientary_projects_delete_hour_entry)   | Delete a time entry      |
| [`clientary_projects_delete_project`](#clientary_projects_delete_project)         | Delete a project         |
| [`clientary_projects_get_expense`](#clientary_projects_get_expense)               | Get a single expense     |
| [`clientary_projects_get_hour_entry`](#clientary_projects_get_hour_entry)         | Get a time entry         |
| [`clientary_projects_get_project`](#clientary_projects_get_project)               | Get a single project     |
| [`clientary_projects_list_expenses`](#clientary_projects_list_expenses)           | List expenses            |
| [`clientary_projects_list_project_hours`](#clientary_projects_list_project_hours) | List hours for a project |
| [`clientary_projects_list_projects`](#clientary_projects_list_projects)           | List all projects        |
| [`clientary_projects_update_expense`](#clientary_projects_update_expense)         | Update an expense        |
| [`clientary_projects_update_hour_entry`](#clientary_projects_update_hour_entry)   | Update a time entry      |
| [`clientary_projects_update_project`](#clientary_projects_update_project)         | Update a project         |

***

## clientary\_projects\_create\_expense

Create an expense

**Parameters:**

| Parameter | Type   | Required | Default | Description       |
| --------- | ------ | -------- | ------- | ----------------- |
| `expense` | object | Yes      | —       | The expense value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "expense": {
        "type": "object",
        "description": "The expense value",
        "properties": {
          "amount": {
            "type": "number",
            "description": "Expense amount (required)"
          },
          "description": {
            "type": "string",
            "description": "Expense description"
          },
          "incurred_on": {
            "type": "string",
            "description": "Date expense was incurred (YYYY-MM-DD)"
          },
          "client_id": {
            "type": "integer",
            "description": "Associated client ID"
          },
          "project_id": {
            "type": "integer",
            "description": "Associated project ID"
          }
        },
        "required": [
          "amount"
        ]
      }
    },
    "required": [
      "PCID",
      "expense"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_create\_hour\_entry

Create a time entry

**Parameters:**

| Parameter      | Type    | Required | Default | Description  |
| -------------- | ------- | -------- | ------- | ------------ |
| `project_id`   | integer | Yes      | —       | Project ID   |
| `project_item` | object  | Yes      | —       | Project Item |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "project_id": {
        "type": "integer",
        "description": "Project ID"
      },
      "project_item": {
        "type": "object",
        "description": "Project Item",
        "properties": {
          "hours": {
            "type": "number",
            "description": "Number of hours (required)"
          },
          "title": {
            "type": "string",
            "description": "Entry title (required)"
          },
          "description": {
            "type": "string",
            "description": "Entry description"
          },
          "date": {
            "type": "string",
            "description": "Date of the entry (YYYY-MM-DD)"
          }
        },
        "required": [
          "hours",
          "title"
        ]
      }
    },
    "required": [
      "PCID",
      "project_id",
      "project_item"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_create\_project

Create a new project

**Parameters:**

| Parameter | Type   | Required | Default | Description       |
| --------- | ------ | -------- | ------- | ----------------- |
| `project` | object | Yes      | —       | The project value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "project": {
        "type": "object",
        "description": "The project value",
        "properties": {
          "name": {
            "type": "string",
            "description": "Project name (required)"
          },
          "rate": {
            "type": "number",
            "description": "Hourly rate or total cost (required)"
          },
          "number": {
            "type": "string",
            "description": "Unique project number"
          },
          "description": {
            "type": "string",
            "description": "Project description"
          },
          "budget_type": {
            "type": "integer",
            "description": "0 = budgeted hours, 1 = budgeted amount"
          },
          "project_type": {
            "type": "integer",
            "description": "0 = hourly rate, 2 = fixed amount"
          },
          "budget": {
            "type": "number",
            "description": "Budget value"
          },
          "end_date": {
            "type": "string",
            "description": "Project end date"
          },
          "currency_code": {
            "type": "string",
            "description": "Currency code e.g. USD"
          },
          "client_id": {
            "type": "integer",
            "description": "Associated client ID"
          }
        },
        "required": [
          "name",
          "rate"
        ]
      }
    },
    "required": [
      "PCID",
      "project"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_delete\_expense

Delete an expense

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `id`      | integer | Yes      | —       | Expense ID  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Expense ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_delete\_hour\_entry

Delete a time entry

**Parameters:**

| Parameter | Type    | Required | Default | Description   |
| --------- | ------- | -------- | ------- | ------------- |
| `id`      | integer | Yes      | —       | Hour entry ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Hour entry ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_delete\_project

Delete a project

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `id`      | integer | Yes      | —       | Project ID  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Project ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_get\_expense

Get a single expense

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `id`      | integer | Yes      | —       | Expense ID  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Expense ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_get\_hour\_entry

Get a time entry

**Parameters:**

| Parameter | Type    | Required | Default | Description   |
| --------- | ------- | -------- | ------- | ------------- |
| `id`      | integer | Yes      | —       | Hour entry ID |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Hour entry ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_get\_project

Get a single project

**Parameters:**

| Parameter | Type    | Required | Default | Description |
| --------- | ------- | -------- | ------- | ----------- |
| `id`      | integer | Yes      | —       | Project ID  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Project ID"
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_list\_expenses

List expenses

**Parameters:**

| Parameter   | Type   | Required | Default | Description                    |
| ----------- | ------ | -------- | ------- | ------------------------------ |
| `from_date` | string | No       | —       | Start date filter (YYYY-MM-DD) |
| `to_date`   | string | No       | —       | End date filter (YYYY-MM-DD)   |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "from_date": {
        "type": "string",
        "description": "Start date filter (YYYY-MM-DD)"
      },
      "to_date": {
        "type": "string",
        "description": "End date filter (YYYY-MM-DD)"
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_list\_project\_hours

List hours for a project

**Parameters:**

| Parameter    | Type    | Required | Default | Description              |
| ------------ | ------- | -------- | ------- | ------------------------ |
| `project_id` | integer | Yes      | —       | Project ID               |
| `filter`     | string  | No       | —       | Filter by billing status |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "project_id": {
        "type": "integer",
        "description": "Project ID"
      },
      "filter": {
        "type": "string",
        "description": "Filter by billing status",
        "enum": [
          "billed",
          "unbilled"
        ]
      }
    },
    "required": [
      "PCID",
      "project_id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_list\_projects

List all projects

**Parameters:**

| Parameter | Type    | Required | Default | Description                                            |
| --------- | ------- | -------- | ------- | ------------------------------------------------------ |
| `page`    | integer | No       | —       | Page number                                            |
| `filter`  | string  | No       | —       | Filter projects. Use 'all' to include closed projects. |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "page": {
        "type": "integer",
        "description": "Page number"
      },
      "filter": {
        "type": "string",
        "description": "Filter projects. Use 'all' to include closed projects.",
        "enum": [
          "all"
        ]
      }
    },
    "required": [
      "PCID"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_update\_expense

Update an expense

**Parameters:**

| Parameter | Type    | Required | Default | Description       |
| --------- | ------- | -------- | ------- | ----------------- |
| `id`      | integer | Yes      | —       | Expense ID        |
| `expense` | object  | No       | —       | The expense value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Expense ID"
      },
      "expense": {
        "type": "object",
        "description": "The expense value",
        "properties": {
          "amount": {
            "type": "number",
            "description": "Expense amount"
          },
          "description": {
            "type": "string",
            "description": "Expense description"
          },
          "incurred_on": {
            "type": "string",
            "description": "Date expense was incurred"
          },
          "client_id": {
            "type": "integer",
            "description": "Associated client ID"
          },
          "project_id": {
            "type": "integer",
            "description": "Associated project ID"
          }
        }
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_update\_hour\_entry

Update a time entry

**Parameters:**

| Parameter      | Type    | Required | Default | Description   |
| -------------- | ------- | -------- | ------- | ------------- |
| `id`           | integer | Yes      | —       | Hour entry ID |
| `project_item` | object  | No       | —       | Project Item  |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Hour entry ID"
      },
      "project_item": {
        "type": "object",
        "description": "Project Item",
        "properties": {
          "hours": {
            "type": "number",
            "description": "Number of hours"
          },
          "title": {
            "type": "string",
            "description": "Entry title"
          },
          "description": {
            "type": "string",
            "description": "Entry description"
          },
          "date": {
            "type": "string",
            "description": "Date of the entry"
          }
        }
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>

***

## clientary\_projects\_update\_project

Update a project

**Parameters:**

| Parameter | Type    | Required | Default | Description       |
| --------- | ------- | -------- | ------- | ----------------- |
| `id`      | integer | Yes      | —       | Project ID        |
| `project` | object  | No       | —       | The project value |

<Expandable title="inputSchema">
  ```json theme={null}
  {
    "type": "object",
    "properties": {
      "PCID": {
        "type": "string",
        "description": "Pink Connect ID for the authenticated connection"
      },
      "id": {
        "type": "integer",
        "description": "Project ID"
      },
      "project": {
        "type": "object",
        "description": "The project value",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name value"
          },
          "rate": {
            "type": "number",
            "description": "The rate value"
          },
          "number": {
            "type": "string",
            "description": "The number value"
          },
          "description": {
            "type": "string",
            "description": "The description value"
          },
          "budget_type": {
            "type": "integer",
            "description": "Budget Type"
          },
          "project_type": {
            "type": "integer",
            "description": "Project Type"
          },
          "budget": {
            "type": "number",
            "description": "The budget value"
          },
          "end_date": {
            "type": "string",
            "description": "End date for filtering"
          },
          "currency_code": {
            "type": "string",
            "description": "Currency Code"
          },
          "client_id": {
            "type": "integer",
            "description": "Client Id"
          }
        }
      }
    },
    "required": [
      "PCID",
      "id"
    ]
  }
  ```
</Expandable>