---
title: "Add/modify a project"
method: POST
path: "/company/projects"
tags: ["Configuration"]
---

# Add/modify a project

`POST /company/projects`

## Request

- Base URL: `https://api.altera.co`
- URL: `https://api.altera.co/company/projects`
- Auth: API key in header `Authorization`

## Request body

- InvoiceTag
  - `tagId` integer
  - `name` string
  - `enabled` boolean
  - `color` integer

## Response `200`

OK

- object
  - `result` string
  - `data` InvoiceTag[]
    - `tagId` integer
    - `name` string
    - `enabled` boolean
    - `color` integer

## Other responses

- `401`: KEY_EXPIRED: a verified API key has expired. This requires that the company still has OpenAPI access. Unknown/invalid keys can receive the gateway 403.

## Changes

- **2026-10-12** `45544bcb4e8a`: 1 info
  - added the non-success response with the status `401`
- **2024-08-26** `64c683372c45`: 1 info
  - endpoint added
- **2024-08-26** `a2d864f3a8db`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/altera-co/apis/altera-api/changes/company/projects/post.md)

---

[API](https://skmtc.dev/altera-co/apis/altera-api.md) - [All operations](https://skmtc.dev/altera-co/apis/altera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altera-co/apis/altera-api/revisions/45544bcb4e8a?raw)