docs

API — Companii

Operații pentru companiile gestionate în workspace-ul tău.

API — Companii

Endpoint-urile pentru companii sunt relevante în principal pentru workspace-ul multi-client (planul Consultant), unde gestionezi mai multe companii client simultan.


GET /companies

Returnează companiile din workspace-ul tău.

Request:

GET /companies
Authorization: Bearer <access_token>

Răspuns de succes (200):

{
  "data": [
    {
      "id": "uuid-companie",
      "name": "Client Constructii SRL",
      "description": "Lucrări de construcții civile, regiunea Sud",
      "active": true,
      "watchlistCount": 3,
      "createdAt": "2026-04-01T12:00:00Z"
    }
  ]
}

GET /companies/:id

Returnează detaliile unei companii specifice, inclusiv watchlist-urile asociate.

Request:

GET /companies/uuid-companie
Authorization: Bearer <access_token>

Răspuns de succes (200):

{
  "data": {
    "id": "uuid-companie",
    "name": "Client Constructii SRL",
    "description": "Lucrări de construcții civile, regiunea Sud",
    "active": true,
    "watchlists": [
      {
        "id": "uuid-watchlist",
        "name": "Drumuri județene",
        "active": true
      }
    ],
    "createdAt": "2026-04-01T12:00:00Z"
  }
}

PATCH /companies/:id

Actualizează datele unei companii.

Request:

PATCH /companies/uuid-companie
Authorization: Bearer <access_token>
Content-Type: application/json
{
  "description": "Lucrări de construcții civile și hidrotehnice, național"
}

Răspuns de succes (200): obiectul companie actualizat.


Erori frecvente

CodCauză
403Planul curent nu include workspace multi-client (Consultant necesar)
404Compania nu există sau nu îți aparține

Vezi și

On this page