{ "openapi": "3.1.0", "info": { "title": "Gantlog API pública", "version": "v1", "description": "API pública de Gantlog (HU-93). Autenticación: `Authorization: Bearer glk_…` (una clave de API de la empresa, con alcances). Errores Problem Details, paginación, `ETag`/`If-Match` e `Idempotency-Key` según las convenciones de la API. Límites por plan con `RateLimit-Limit`, `RateLimit-Remaining` y `RateLimit-Reset` en cada respuesta y `429 rate-limited` con `Retry-After`." }, "servers": [ { "url": "http://localhost/api/v1", "description": "Generated server url" } ], "security": [ { "apiKey": [] } ], "tags": [ { "name": "calendar" }, { "name": "control" }, { "name": "execution" }, { "name": "identity" }, { "name": "integration" }, { "name": "planning" }, { "name": "progress" } ], "paths": { "/api/v1/users/{userId}/calendar": { "get": { "tags": [ "calendar" ], "operationId": "calendarOfUser", "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalendarView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/tasks/{taskId}/predecessors": { "put": { "tags": [ "planning" ], "operationId": "dependencyReplace", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Predecessors" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/Predecessor" } } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:write", "description": "Alcance: `projects:write`." } }, "/api/v1/tasks/{taskId}/assignments": { "get": { "tags": [ "planning" ], "operationId": "assignmentList", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AssignmentView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." }, "put": { "tags": [ "planning" ], "operationId": "assignmentReplace", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignmentSet" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AssignmentView" } } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "assignments:write", "description": "Alcance: `assignments:write`." } }, "/api/v1/work-logs": { "post": { "tags": [ "execution" ], "operationId": "workLogCreate", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewWorkLog" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkLogView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "time:write", "description": "Alcance: `time:write`." } }, "/api/v1/webhooks": { "get": { "tags": [ "integration" ], "operationId": "webhookList", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/WebhookView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." }, "post": { "tags": [ "integration" ], "operationId": "webhookCreate", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatedWebhook" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/{id}/deliveries/{deliveryId}/actions/resend": { "post": { "tags": [ "integration" ], "operationId": "webhookResend", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "deliveryId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "202": { "description": "Accepted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string", "format": "uuid" } } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/{id}/actions/test": { "post": { "tags": [ "integration" ], "operationId": "webhookTest", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "202": { "description": "Accepted", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string", "format": "uuid" } } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/{id}/actions/rotate-secret": { "post": { "tags": [ "integration" ], "operationId": "webhookRotateSecret", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatedWebhook" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/triggers/work-log-created": { "post": { "tags": [ "integration" ], "operationId": "webhookTriggerWorkLogCreated", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/triggers/time-approved": { "post": { "tags": [ "integration" ], "operationId": "webhookTriggerTimeApproved", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/triggers/task-status-changed": { "post": { "tags": [ "integration" ], "operationId": "webhookTriggerTaskStatusChanged", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/triggers/task-created": { "post": { "tags": [ "integration" ], "operationId": "webhookTriggerTaskCreated", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/triggers/alert-raised": { "post": { "tags": [ "integration" ], "operationId": "webhookTriggerAlertRaised", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TriggerRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/users/{userId}/work-schedules": { "get": { "tags": [ "calendar" ], "operationId": "workScheduleOverview", "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScheduleOverview" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/tasks/{taskId}/progress-updates": { "get": { "tags": [ "execution" ], "operationId": "progressList", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskProgressView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." }, "post": { "tags": [ "execution" ], "operationId": "progressCreate", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "If-Match", "in": "header", "required": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewProgressUpdate" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskProgressView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "time:write", "description": "Alcance: `time:write`." } }, "/api/v1/projects": { "get": { "tags": [ "planning" ], "operationId": "projectList", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ProjectView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." }, "post": { "tags": [ "planning" ], "operationId": "projectCreate", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewProjectRequest" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:write", "description": "Alcance: `projects:write`." } }, "/api/v1/projects/{projectId}/tasks": { "get": { "tags": [ "planning" ], "operationId": "taskPlan", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TaskView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." }, "post": { "tags": [ "planning" ], "operationId": "taskCreate", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewTask" } } }, "required": true }, "responses": { "201": { "description": "Created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:write", "description": "Alcance: `projects:write`." } }, "/api/v1/calendars": { "get": { "tags": [ "calendar" ], "operationId": "calendarList", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CalendarView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/calendars/{id}/holidays": { "get": { "tags": [ "calendar" ], "operationId": "calendarHolidays", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "year", "in": "query", "required": true, "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/HolidayView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/absences": { "get": { "tags": [ "calendar" ], "operationId": "absenceList", "parameters": [ { "name": "userId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/AbsenceView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/absence-types": { "get": { "tags": [ "calendar" ], "operationId": "absenceTypes", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TypeView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/work-logs/{id}": { "delete": { "tags": [ "execution" ], "operationId": "workLogDelete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "time:write", "description": "Alcance: `time:write`." }, "patch": { "tags": [ "execution" ], "operationId": "workLogUpdate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/merge-patch+json": { "schema": { "$ref": "#/components/schemas/WorkLogPatch" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WorkLogPatch" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkLogView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "time:write", "description": "Alcance: `time:write`." } }, "/api/v1/webhooks/{id}": { "get": { "tags": [ "integration" ], "operationId": "webhookGet", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." }, "delete": { "tags": [ "integration" ], "operationId": "webhookDelete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." }, "patch": { "tags": [ "integration" ], "operationId": "webhookUpdate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/merge-patch+json": { "schema": { "$ref": "#/components/schemas/WebhookPatch" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WebhookPatch" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/tasks/{id}": { "delete": { "tags": [ "planning" ], "operationId": "taskDelete", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "confirmed", "in": "query", "required": false, "schema": { "type": "boolean", "default": false } } ], "responses": { "204": { "description": "No Content" }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:write", "description": "Alcance: `projects:write`." }, "patch": { "tags": [ "planning" ], "operationId": "taskUpdate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/merge-patch+json": { "schema": { "type": "object", "additionalProperties": {} } }, "application/json": { "schema": { "type": "object", "additionalProperties": {} } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:write", "description": "Alcance: `projects:write`." } }, "/api/v1/projects/{id}": { "get": { "tags": [ "planning" ], "operationId": "projectGet", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." }, "patch": { "tags": [ "planning" ], "operationId": "projectUpdate", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "content": { "application/merge-patch+json": { "schema": { "type": "object", "additionalProperties": {} } }, "application/json": { "schema": { "type": "object", "additionalProperties": {} } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectView" } } } }, "400": { "$ref": "#/components/responses/ValidationError" }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "409": { "$ref": "#/components/responses/Conflict" }, "422": { "$ref": "#/components/responses/BusinessRule" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:write", "description": "Alcance: `projects:write`." } }, "/api/v1/calendars/{id}": { "get": { "tags": [ "calendar" ], "operationId": "calendarGet", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CalendarView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/absences/{id}": { "get": { "tags": [ "calendar" ], "operationId": "absenceGet", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AbsenceView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/webhooks/{id}/deliveries": { "get": { "tags": [ "integration" ], "operationId": "webhookDeliveries", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "before", "in": "query", "required": false, "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DeliveryView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/webhooks/event-types": { "get": { "tags": [ "integration" ], "operationId": "webhookEventTypes", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "string" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "webhooks:manage", "description": "Alcance: `webhooks:manage`." } }, "/api/v1/users": { "get": { "tags": [ "identity" ], "operationId": "userList", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/users/{userId}/capacity": { "get": { "tags": [ "calendar" ], "operationId": "workScheduleCapacity", "parameters": [ { "name": "userId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "from", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } }, { "name": "to", "in": "query", "required": true, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/DayView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "users:read", "description": "Alcance: `users:read`." } }, "/api/v1/tasks/{taskId}/work-logs": { "get": { "tags": [ "execution" ], "operationId": "workLogList", "parameters": [ { "name": "taskId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskWorkLogs" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } }, "/api/v1/tasks/{id}/dev-activity": { "get": { "tags": [ "integration" ], "operationId": "devActivityOfTask", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "kind", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 0 } }, { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 50 } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DevActivityPage" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } }, "/api/v1/projects/{projectId}/progress-curve": { "get": { "tags": [ "progress" ], "operationId": "progressCurveGet", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProgressCurveView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } }, "/api/v1/projects/{projectId}/plan": { "get": { "tags": [ "planning" ], "operationId": "taskPlanWithSummary", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlanView" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } }, "/api/v1/projects/{projectId}/off-plan-tasks": { "get": { "tags": [ "planning" ], "operationId": "taskOffPlan", "parameters": [ { "name": "projectId", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TaskView" } } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "404": { "$ref": "#/components/responses/NotFound" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } }, "/api/v1/alerts": { "get": { "tags": [ "control" ], "operationId": "alertList", "parameters": [ { "name": "projectId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" } }, { "name": "status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "size", "in": "query", "required": false, "schema": { "type": "integer", "format": "int32", "default": 50 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string" } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertPage" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } }, "/api/v1/alerts/summary": { "get": { "tags": [ "control" ], "operationId": "alertSummary", "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertSummary" } } } }, "401": { "$ref": "#/components/responses/Unauthenticated" }, "403": { "$ref": "#/components/responses/Forbidden" }, "429": { "$ref": "#/components/responses/RateLimited" } }, "x-gantlog-scope": "projects:read", "description": "Alcance: `projects:read`." } } }, "components": { "schemas": { "CalendarView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "countryCode": { "type": "string" }, "region": { "type": "string" }, "timezone": { "type": "string" }, "workdays": { "type": "array", "items": { "type": "integer", "format": "int32" } }, "weeklyHours": { "type": "array", "items": { "type": "number" } }, "isDefault": { "type": "boolean" }, "active": { "type": "boolean" }, "users": { "type": "integer", "format": "int32" } } }, "PredecessorInput": { "type": "object", "properties": { "taskId": { "type": "string", "format": "uuid" }, "type": { "type": "string", "pattern": "FS|SS" }, "lagDays": { "type": "integer", "format": "int32", "maximum": 999, "minimum": -999 } }, "required": [ "taskId" ] }, "Predecessors": { "type": "object", "properties": { "predecessors": { "type": "array", "items": { "$ref": "#/components/schemas/PredecessorInput" } }, "predecessorIds": { "type": "array", "items": { "type": "string", "format": "uuid" } } } }, "Predecessor": { "type": "object", "properties": { "taskId": { "type": "string", "format": "uuid" }, "type": { "type": "string", "enum": [ "FS", "SS" ] }, "lagDays": { "type": "integer", "format": "int32" } } }, "AssignmentRequest": { "type": "object", "properties": { "userId": { "type": "string", "format": "uuid" }, "allocationPct": { "type": "number", "maximum": 100, "minimum": 1 }, "estimateHours": { "type": "number", "maximum": 99999, "minimum": 0.25 } }, "required": [ "allocationPct", "userId" ] }, "AssignmentSet": { "type": "object", "properties": { "assignments": { "type": "array", "items": { "$ref": "#/components/schemas/AssignmentRequest" } }, "confirmRemoval": { "type": "boolean" }, "overallocationConfirmation": { "$ref": "#/components/schemas/OverallocationConfirmation" }, "unassigned": { "type": "array", "items": { "$ref": "#/components/schemas/UnassignedRequest" } } }, "required": [ "assignments" ] }, "OverallocationConfirmation": { "type": "object", "properties": { "reason": { "type": "string", "maxLength": 500, "minLength": 0 } }, "required": [ "reason" ] }, "UnassignedRequest": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "profile": { "type": "string", "maxLength": 100, "minLength": 0 }, "profileId": { "type": "string", "format": "uuid" }, "allocationPct": { "type": "number", "maximum": 100, "minimum": 1 }, "estimateHours": { "type": "number", "maximum": 99999, "minimum": 0.25 } }, "required": [ "estimateHours" ] }, "AssignmentView": { "type": "object", "properties": { "userId": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" }, "allocationPct": { "type": "number" }, "estimateHours": { "type": "number" }, "progressPct": { "type": "number" }, "loggedHours": { "type": "number" }, "startDate": { "type": "string", "format": "date" }, "finishDate": { "type": "string", "format": "date" }, "completed": { "type": "boolean" }, "earnedHours": { "type": "number" }, "efficiencyPct": { "type": "number" }, "projectedHours": { "type": "number" }, "projectedFinish": { "type": "string", "format": "date" } } }, "TaskView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "parentId": { "type": "string", "format": "uuid" }, "kind": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "descriptionHtml": { "type": "string" }, "startDate": { "type": "string", "format": "date" }, "finishDate": { "type": "string", "format": "date" }, "estimateHours": { "type": "number" }, "progressPct": { "type": "number" }, "loggedHours": { "type": "number" }, "children": { "type": "integer", "format": "int32" }, "assignees": { "type": "array", "items": { "$ref": "#/components/schemas/AssignmentView" } }, "predecessorIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "predecessors": { "type": "array", "items": { "$ref": "#/components/schemas/Predecessor" } }, "notBefore": { "type": "string", "format": "date" }, "baselineStart": { "type": "string", "format": "date" }, "baselineFinish": { "type": "string", "format": "date" }, "baselineHours": { "type": "number" }, "expectedPct": { "type": "number" }, "status": { "type": "string" }, "itemType": { "type": "string" }, "earnedHours": { "type": "number" }, "efficiencyPct": { "type": "number" }, "projectedHours": { "type": "number" }, "projectedVarianceHours": { "type": "number" }, "overrunHours": { "type": "number" }, "consumptionPct": { "type": "number" }, "deviationPp": { "type": "number" }, "scheduleStatus": { "type": "string" }, "projectedFinish": { "type": "string", "format": "date" }, "finishDelayDays": { "type": "integer", "format": "int32" }, "actualStart": { "type": "string", "format": "date" }, "actualFinish": { "type": "string", "format": "date" }, "actualStartManual": { "type": "boolean" }, "actualFinishManual": { "type": "boolean" }, "dueDate": { "type": "string", "format": "date" }, "editable": { "type": "boolean" }, "customValues": { "type": "object", "additionalProperties": {} }, "priority": { "type": "string" }, "storyPoints": { "type": "number" }, "tags": { "type": "array", "items": { "type": "string" } }, "deadline": { "type": "string", "format": "date" }, "milestone": { "type": "boolean" }, "deadlineMissed": { "type": "boolean" }, "number": { "type": "integer", "format": "int32" }, "key": { "type": "string" }, "attachments": { "type": "integer", "format": "int32" }, "subtasks": { "type": "integer", "format": "int32" }, "subtasksDone": { "type": "integer", "format": "int32" }, "inPlan": { "type": "boolean" }, "openToAll": { "type": "boolean" }, "unassigned": { "type": "array", "items": { "$ref": "#/components/schemas/UnassignedEffort" } } } }, "UnassignedEffort": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "profile": { "type": "string" }, "profileId": { "type": "string", "format": "uuid" }, "allocationPct": { "type": "number" }, "estimateHours": { "type": "number" }, "startDate": { "type": "string", "format": "date" }, "finishDate": { "type": "string", "format": "date" } } }, "Person": { "type": "object", "properties": { "userId": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" } } }, "NewWorkLog": { "type": "object", "properties": { "taskId": { "type": "string", "format": "uuid" }, "workDate": { "type": "string", "format": "date" }, "hours": { "type": "number", "exclusiveMinimum": 0, "maximum": 24 }, "note": { "type": "string", "maxLength": 1000, "minLength": 0 }, "progressPct": { "type": "number", "maximum": 99, "minimum": 0 } }, "required": [ "hours", "taskId", "workDate" ] }, "WorkLogView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "taskId": { "type": "string", "format": "uuid" }, "userId": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" }, "workDate": { "type": "string", "format": "date" }, "hours": { "type": "number" }, "note": { "type": "string" }, "status": { "type": "string" }, "editable": { "type": "boolean" }, "imported": { "type": "boolean" } } }, "WebhookRequest": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2000, "minLength": 0 }, "events": { "type": "array", "items": { "type": "string" }, "minItems": 1 }, "projectIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "description": { "type": "string", "maxLength": 200, "minLength": 0 } }, "required": [ "events", "url" ] }, "CreatedWebhook": { "type": "object", "properties": { "webhook": { "$ref": "#/components/schemas/WebhookView" }, "secret": { "type": "string" } } }, "LastDelivery": { "type": "object", "properties": { "status": { "type": "string" }, "at": { "type": "string", "format": "date-time" }, "statusCode": { "type": "integer", "format": "int32" } } }, "WebhookView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "url": { "type": "string" }, "description": { "type": "string" }, "events": { "type": "array", "items": { "type": "string" } }, "projectIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "status": { "type": "string" }, "pausedReason": { "type": "string" }, "failingSince": { "type": "string", "format": "date-time" }, "createdByName": { "type": "string" }, "createdByKey": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "lastDelivery": { "$ref": "#/components/schemas/LastDelivery" } } }, "TriggerRequest": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2000, "minLength": 0 }, "projectIds": { "type": "array", "items": { "type": "string", "format": "uuid" } } }, "required": [ "url" ] }, "ScheduleView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "validFrom": { "type": "string", "format": "date" }, "useCalendar": { "type": "boolean" }, "weeklyHours": { "type": "array", "items": { "type": "number" } }, "deletable": { "type": "boolean" } } }, "NewProgressUpdate": { "type": "object", "properties": { "progressPct": { "type": "number", "maximum": 100, "minimum": 0 }, "note": { "type": "string", "maxLength": 1000, "minLength": 0 }, "userId": { "type": "string", "format": "uuid" } }, "required": [ "progressPct" ] }, "PersonProgress": { "type": "object", "properties": { "userId": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" }, "estimateHours": { "type": "number" }, "loggedHours": { "type": "number" }, "progressPct": { "type": "number" }, "completed": { "type": "boolean" }, "outdated": { "type": "boolean" }, "updatedAt": { "type": "string", "format": "date-time" }, "earnedHours": { "type": "number" }, "efficiencyPct": { "type": "number" }, "projectedHours": { "type": "number" } } }, "ProgressUpdateView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "userId": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" }, "progressPct": { "type": "number" }, "note": { "type": "string" }, "reportDate": { "type": "string", "format": "date" }, "createdAt": { "type": "string", "format": "date-time" }, "reportedByName": { "type": "string" } } }, "TaskProgressView": { "type": "object", "properties": { "taskId": { "type": "string", "format": "uuid" }, "taskName": { "type": "string" }, "projectId": { "type": "string", "format": "uuid" }, "status": { "type": "string" }, "progressPct": { "type": "number" }, "estimateHours": { "type": "number" }, "loggedHours": { "type": "number" }, "projectedHours": { "type": "number" }, "overEffort": { "type": "boolean" }, "canReport": { "type": "boolean" }, "canReportOthers": { "type": "boolean" }, "mine": { "$ref": "#/components/schemas/PersonProgress" }, "people": { "type": "array", "items": { "$ref": "#/components/schemas/PersonProgress" } }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/ProgressUpdateView" } }, "earnedHours": { "type": "number" }, "efficiencyPct": { "type": "number" }, "projectedVarianceHours": { "type": "number" }, "overrunHours": { "type": "number" }, "consumptionPct": { "type": "number" } } }, "AlertView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "type": { "type": "string" }, "status": { "type": "string" }, "projectId": { "type": "string", "format": "uuid" }, "projectCode": { "type": "string" }, "projectName": { "type": "string" }, "taskId": { "type": "string", "format": "uuid" }, "taskName": { "type": "string" }, "details": { "type": "object", "additionalProperties": {} }, "createdAt": { "type": "string", "format": "date-time" }, "resolvedAt": { "type": "string", "format": "date-time" }, "decision": { "$ref": "#/components/schemas/Decision" }, "decisions": { "type": "array", "items": { "$ref": "#/components/schemas/Decision" } } } }, "Decision": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "action": { "type": "string" }, "decidedBy": { "type": "string", "format": "uuid" }, "decidedByName": { "type": "string" }, "decidedAt": { "type": "string", "format": "date-time" }, "reason": { "type": "string" }, "details": { "type": "object", "additionalProperties": {} } } }, "NewProjectRequest": { "type": "object", "properties": { "kind": { "type": "string", "pattern": "PLAN|BOARD" }, "code": { "type": "string", "pattern": "^[A-Z0-9]{2,10}$" }, "name": { "type": "string", "maxLength": 120, "minLength": 0 }, "description": { "type": "string", "maxLength": 2000, "minLength": 0 }, "descriptionHtml": { "type": "string", "maxLength": 200000, "minLength": 0 }, "startDate": { "type": "string", "format": "date" }, "pmId": { "type": "string", "format": "uuid" }, "primaryLeadId": { "type": "string", "format": "uuid" }, "customValues": { "type": "object", "additionalProperties": {} } }, "required": [ "code", "kind", "name", "pmId" ] }, "ProjectView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "code": { "type": "string" }, "name": { "type": "string" }, "description": { "type": "string" }, "descriptionHtml": { "type": "string" }, "kind": { "type": "string" }, "status": { "type": "string" }, "internal": { "type": "boolean" }, "startDate": { "type": "string", "format": "date" }, "finishDate": { "type": "string", "format": "date" }, "pm": { "$ref": "#/components/schemas/Person" }, "owner": { "$ref": "#/components/schemas/Person" }, "projectRole": { "type": "string" }, "canManage": { "type": "boolean" }, "statusDate": { "type": "string", "format": "date" }, "baselineFinish": { "type": "string", "format": "date" }, "projectedFinish": { "type": "string", "format": "date" }, "finishDelayDays": { "type": "integer", "format": "int32" }, "customValues": { "type": "object", "additionalProperties": {} }, "budgetHours": { "type": "number" }, "estimateHours": { "type": "number" }, "unassignedHours": { "type": "number" } } }, "NewTask": { "type": "object", "properties": { "kind": { "type": "string", "pattern": "PHASE|TASK" }, "name": { "type": "string", "maxLength": 200, "minLength": 0 }, "description": { "type": "string", "maxLength": 4000, "minLength": 0 }, "descriptionHtml": { "type": "string", "maxLength": 200000, "minLength": 0 }, "parentId": { "type": "string", "format": "uuid" }, "position": { "type": "integer", "format": "int32", "minimum": 0 }, "customValues": { "type": "object", "additionalProperties": {} }, "priority": { "type": "string", "pattern": "LOW|MEDIUM|HIGH|CRITICAL" }, "storyPoints": { "type": "number", "maximum": 999, "minimum": 0 }, "tags": { "type": "array", "items": { "type": "string" } }, "deadline": { "type": "string", "format": "date" }, "milestone": { "type": "boolean" }, "inPlan": { "type": "boolean" }, "openToAll": { "type": "boolean" } }, "required": [ "kind", "name" ] }, "HolidayView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "date": { "type": "string", "format": "date" }, "name": { "type": "string" } } }, "AbsenceView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "userId": { "type": "string", "format": "uuid" }, "userName": { "type": "string" }, "type": { "$ref": "#/components/schemas/TypeRef" }, "note": { "type": "string" }, "detailsHidden": { "type": "boolean" }, "startDate": { "type": "string", "format": "date" }, "endDate": { "type": "string", "format": "date" }, "hoursPerDay": { "type": "number" }, "workingDays": { "type": "integer", "format": "int32" }, "hours": { "type": "number" }, "createdBy": { "type": "string", "format": "uuid" }, "canEdit": { "type": "boolean" }, "source": { "type": "string" } } }, "TypeRef": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "code": { "type": "string" }, "name": { "type": "string" } } }, "TypeView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "code": { "type": "string" }, "name": { "type": "string" }, "position": { "type": "integer", "format": "int32" }, "active": { "type": "boolean" }, "inUse": { "type": "boolean" } } }, "WorkLogPatch": { "type": "object", "properties": { "workDate": { "type": "string", "format": "date" }, "hours": { "type": "number", "exclusiveMinimum": 0, "maximum": 24 }, "note": { "type": "string", "maxLength": 1000, "minLength": 0 } } }, "WebhookPatch": { "type": "object", "properties": { "url": { "type": "string", "maxLength": 2000, "minLength": 0 }, "events": { "type": "array", "items": { "type": "string" } }, "projectIds": { "type": "array", "items": { "type": "string", "format": "uuid" } }, "description": { "type": "string", "maxLength": 200, "minLength": 0 }, "status": { "type": "string" } } }, "UserView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "fullName": { "type": "string" }, "email": { "type": "string" }, "role": { "type": "string" }, "status": { "type": "string" }, "supervisorId": { "type": "string", "format": "uuid" }, "createdAt": { "type": "string", "format": "date-time" } } }, "AttemptView": { "type": "object", "properties": { "attempt": { "type": "integer", "format": "int32" }, "at": { "type": "string", "format": "date-time" }, "statusCode": { "type": "integer", "format": "int32" }, "durationMs": { "type": "integer", "format": "int32" }, "error": { "type": "string" } } }, "DeliveryView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "eventId": { "type": "string", "format": "uuid" }, "type": { "type": "string" }, "status": { "type": "string" }, "attempts": { "type": "integer", "format": "int32" }, "createdAt": { "type": "string", "format": "date-time" }, "deliveredAt": { "type": "string", "format": "date-time" }, "nextAttemptAt": { "type": "string", "format": "date-time" }, "test": { "type": "boolean" }, "attemptLog": { "type": "array", "items": { "$ref": "#/components/schemas/AttemptView" } } } }, "CalendarRef": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "weeklyHours": { "type": "array", "items": { "type": "number" } } } }, "Current": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "PERSONAL", "CALENDAR" ] }, "scheduleId": { "type": "string", "format": "uuid" }, "validFrom": { "type": "string", "format": "date" }, "weeklyHours": { "type": "array", "items": { "type": "number" } } } }, "ScheduleOverview": { "type": "object", "properties": { "calendar": { "$ref": "#/components/schemas/CalendarRef" }, "current": { "$ref": "#/components/schemas/Current" }, "schedules": { "type": "array", "items": { "$ref": "#/components/schemas/ScheduleView" } } } }, "DayView": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "hours": { "type": "number" } } }, "MyAssignment": { "type": "object", "properties": { "estimateHours": { "type": "number" }, "loggedHours": { "type": "number" }, "progressPct": { "type": "number" }, "completed": { "type": "boolean" }, "progressOutdated": { "type": "boolean" } } }, "TaskWorkLogs": { "type": "object", "properties": { "taskId": { "type": "string", "format": "uuid" }, "taskName": { "type": "string" }, "projectId": { "type": "string", "format": "uuid" }, "today": { "type": "string", "format": "date" }, "firstDate": { "type": "string", "format": "date" }, "lastDate": { "type": "string", "format": "date" }, "canLog": { "type": "boolean" }, "allPeople": { "type": "boolean" }, "totalHours": { "type": "number" }, "mine": { "$ref": "#/components/schemas/MyAssignment" }, "entries": { "type": "array", "items": { "$ref": "#/components/schemas/WorkLogView" } } } }, "DevActivityPage": { "type": "object", "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/DevActivityView" } }, "page": { "type": "integer", "format": "int32" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "totalPages": { "type": "integer", "format": "int32" }, "repositoriesLinked": { "type": "boolean" } } }, "DevActivityView": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "kind": { "type": "string" }, "provider": { "type": "string" }, "repository": { "type": "string" }, "key": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" }, "state": { "type": "string" }, "targetBranch": { "type": "string" }, "number": { "type": "integer", "format": "int32" }, "authorName": { "type": "string" }, "authorUserId": { "type": "string", "format": "uuid" }, "occurredAt": { "type": "string", "format": "date-time" }, "mergedAt": { "type": "string", "format": "date-time" } } }, "CurvePoint": { "type": "object", "properties": { "date": { "type": "string", "format": "date" }, "expectedPct": { "type": "number" }, "actualPct": { "type": "number" }, "expectedHours": { "type": "number" }, "earnedHours": { "type": "number" } } }, "ProgressCurveView": { "type": "object", "properties": { "projectId": { "type": "string", "format": "uuid" }, "baselineVersion": { "type": "integer", "format": "int32" }, "baselineHours": { "type": "number" }, "estimateHours": { "type": "number" }, "statusDate": { "type": "string", "format": "date" }, "realUntil": { "type": "string", "format": "date" }, "points": { "type": "array", "items": { "$ref": "#/components/schemas/CurvePoint" } } } }, "PlanView": { "type": "object", "properties": { "summary": { "$ref": "#/components/schemas/TaskView" }, "tasks": { "type": "array", "items": { "$ref": "#/components/schemas/TaskView" } } } }, "AlertPage": { "type": "object", "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/AlertView" } }, "nextCursor": { "type": "string" } } }, "AlertSummary": { "type": "object", "properties": { "open": { "type": "integer", "format": "int32" } } }, "Problem": { "type": "object", "description": "Problem Details (RFC 9457) con el `code` del catálogo de errores", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "status": { "type": "integer", "format": "int32" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "code": { "type": "string" }, "traceId": { "type": "string" }, "errors": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string" }, "code": { "type": "string" }, "message": { "type": "string" } } } } } } }, "securitySchemes": { "apiKey": { "type": "http", "scheme": "bearer", "bearerFormat": "glk_", "description": "Clave de API de la empresa (Configuración → Integraciones)" } }, "responses": { "BusinessRule": { "description": "Viola una regla del negocio (`business-rule`)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "Conflict": { "description": "El estado actual no lo permite o cambió desde que se leyó (`invalid-state`, `version-conflict`, `duplicate`)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "Forbidden": { "description": "La clave no tiene el alcance de la operación o el plan no la incluye (`forbidden`)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "NotFound": { "description": "No existe o la clave no lo ve (`not-found`)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "RateLimited": { "description": "Se pasó el límite del plan (`rate-limited`); esperar lo que dice `Retry-After`", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "Unauthenticated": { "description": "Sin clave, o la clave está revocada, vencida o no existe (`unauthenticated`)", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "ValidationError": { "description": "Datos inválidos (`validation-error`), con `errors[]` por campo", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }