{ "openapi": "3.1.0", "paths": { "/individuals/resolve": { "post": { "description": "Find or create an individual by email or HRIS ID within the tenant context", "operationId": "resolveIdentity", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveIndividualDto" } } } }, "responses": { "200": { "description": "Individual resolved", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResolveIndividualResponseDto" } } } }, "400": { "description": "Invalid request payload", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — admin or owner required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } }, "409": { "description": "Email and HRIS ID resolve to different individuals (IDENTITY_RESOLUTION_CONFLICT)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" } } } } }, "summary": "Resolve individual", "tags": [ "Colleagues & Profiles" ], "x-badges": [ { "name": "Admin" }, { "name": "Owner" } ] } }, "/colleagues": { "post": { "description": "Create a single colleague profile by email. Returns 201 on creation, 200 with reactivation offer for archived profiles, 409 for duplicates.", "operationId": "createColleague", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateColleagueDto" } } } }, "responses": { "200": { "description": "Archived profile found — reactivation offer returned (classification: \"reactivate\")", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReactivateColleagueOfferDto" } } } }, "201": { "description": "Colleague profile created successfully (classification: \"created\")", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatedColleagueResponseDto" } } } }, "400": { "description": "Validation error in request body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — admin or owner required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } }, "409": { "description": "Duplicate email (DUPLICATE_EMAIL)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 409, "message": "A colleague with this email already exists", "error": "DUPLICATE_EMAIL" } } } } }, "summary": "Create a colleague profile", "tags": [ "People Administration" ], "x-badges": [ { "name": "Admin" }, { "name": "Owner" } ] } }, "/colleagues/bulk/validate": { "post": { "description": "Classifies each row as ready, reactivate, or rejected. Read-only — no data is persisted.", "operationId": "bulkValidateColleagues", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkValidateRequestDto" } } } }, "responses": { "200": { "description": "Validation results with per-row classification", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkValidateResponseDto" } } } }, "400": { "description": "Validation error (e.g., >100 rows, empty array)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — admin or owner required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } } }, "summary": "Validate bulk colleague creation", "tags": [ "People Administration" ], "x-badges": [ { "name": "Admin" }, { "name": "Owner" } ] } }, "/colleagues/bulk": { "post": { "description": "Atomically creates/reactivates confirmed rows. Re-validates inside transaction for race condition safety.", "operationId": "bulkCreateColleagues", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkCreateRequestDto" } } } }, "responses": { "201": { "description": "Bulk creation results with per-row details", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkCreateResponseDto" } } } }, "400": { "description": "Validation error in request body", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — admin or owner required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } } }, "summary": "Bulk create colleague profiles", "tags": [ "People Administration" ], "x-badges": [ { "name": "Admin" }, { "name": "Owner" } ] } }, "/ai-coaching/conversations": { "post": { "operationId": "createCoachingConversation", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateConversationBodyDto" } } } }, "responses": { "201": { "description": "AI coaching conversation created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationResponseDto" } } } }, "400": { "description": "Invalid request payload", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } } }, "summary": "Create AI coaching conversation", "tags": [ "AI Coaching" ] }, "get": { "operationId": "listCoachingConversations", "parameters": [ { "name": "cursor", "required": false, "in": "query", "x-nestjs_zod-parent-additional-properties": false, "schema": { "minLength": 1, "type": "string" } }, { "name": "limit", "required": false, "in": "query", "x-nestjs_zod-parent-additional-properties": false, "schema": { "minimum": 1, "maximum": 100, "default": 50, "type": "integer" } } ], "responses": { "200": { "description": "List of AI coaching conversations", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationsListResponseDto" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } } }, "summary": "List AI coaching conversations", "tags": [ "AI Coaching" ] } }, "/assessments/connection-power": { "get": { "operationId": "getMyConnectionPower", "parameters": [], "responses": { "200": { "description": "Connection Power type + completion timestamp (both null if never assessed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectionPowerResponseDto" } } } }, "401": { "description": "Invalid or missing authentication token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } } }, "summary": "Get the authenticated user's own Connection Power", "tags": [ "Behaviour" ] } }, "/assessments/profile/{individualId}": { "get": { "operationId": "getAssessmentBehaviourProfile", "parameters": [ { "name": "individualId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Behaviour profile with trait spectrums and solo insights", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BehaviourProfileResponseDto" } } } }, "400": { "description": "Malformed individualId path parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed (uuid is expected)", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Cannot access another user's assessment profile", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Cannot access another user's assessment profile", "error": "ASSESSMENT_FORBIDDEN" } } } }, "404": { "description": "No scored assessment found for this individual", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 404, "message": "No scored assessment found for this individual", "error": "ASSESSMENT_PROFILE_NOT_FOUND" } } } } }, "summary": "Get behaviour profile for an individual", "tags": [ "Behaviour" ] } }, "/assessments/assignments": { "post": { "operationId": "createAssessmentAssignment", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAssignmentRequestDto" } } } }, "responses": { "201": { "description": "Assignment created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignmentResponseDto" } } } }, "400": { "description": "Invalid request payload", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — owner or admin required for cross-user assignment", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Only owners and admins can assign assessments to other users", "error": "AUTH_INSUFFICIENT_ROLE" } } } } }, "summary": "Create assessment assignment", "tags": [ "Assignments" ] }, "get": { "operationId": "listAssessmentAssignments", "parameters": [ { "name": "status", "required": false, "in": "query", "schema": { "type": "string", "enum": [ "PENDING", "COMPLETED", "EXPIRED" ] } }, { "name": "individualId", "required": false, "in": "query", "schema": { "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "type": "string" } } ], "responses": { "200": { "description": "List of assignments", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignmentListResponseDto" } } } }, "400": { "description": "Malformed individualId query parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — owner or admin required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } } }, "summary": "List assessment assignments", "tags": [ "Assignments" ], "x-badges": [ { "name": "Owner" }, { "name": "Admin" } ] } }, "/assessments/assignments/bulk": { "post": { "operationId": "bulkCreateAssessmentAssignments", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkCreateAssignmentRequestDto" } } } }, "responses": { "201": { "description": "Bulk assignments created successfully", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkAssignmentResponseDto" } } } }, "400": { "description": "Invalid request payload", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Insufficient role — owner or admin required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } }, "404": { "description": "One or more individuals not found in organisation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 404, "message": "One or more individuals not found in organisation", "error": "IDENTITY_COMPANY_INDIVIDUAL_NOT_FOUND" } } } } }, "summary": "Bulk create assessment assignments", "tags": [ "Assignments" ], "x-badges": [ { "name": "Owner" }, { "name": "Admin" } ] } }, "/teams": { "post": { "operationId": "createConnectionTeam", "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateExplicitTeamDto" } } } }, "responses": { "201": { "description": "Connection team created", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TeamWithMembersResponseDto" } } } }, "400": { "description": "Invalid request payload", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } }, "403": { "description": "Creator has not completed a scored behaviour assessment", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "You must complete your behaviour assessment before creating a team", "error": "ASSESSMENT_REQUIRED" } } } } }, "summary": "Create a connection team", "tags": [ "Teams" ] }, "get": { "operationId": "listConnectionTeams", "parameters": [], "responses": { "200": { "description": "List of connection teams for the current user", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListConnectionTeamsResponseDto" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } } }, "summary": "List connection teams for the current user", "tags": [ "Teams" ] } }, "/teams/{teamId}/dynamics": { "get": { "operationId": "getConnectionTeamDynamics", "parameters": [ { "name": "teamId", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Team connection dynamics", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TeamDynamicsResponseDto" } } } }, "400": { "description": "Malformed teamId path parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 400, "message": "Validation failed (uuid is expected)", "error": "HTTP_BAD_REQUEST" } } } }, "401": { "description": "Invalid or missing authentication token (AUTH_TOKEN_INVALID)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 401, "message": "Invalid or missing authentication token", "error": "AUTH_TOKEN_INVALID" } } } } }, "summary": "Get team connection dynamics", "tags": [ "Teams" ] } } }, "info": { "title": "Thomas Platform API", "description": "CXI platform API — auto-generated from Zod contracts", "version": "1.0", "contact": { "name": "Thomas International", "url": "https://thomas.co", "email": "support@thomas.co" } }, "tags": [ { "name": "Colleagues & Profiles", "description": "The employee population — directory, profiles, administration, roles and the manager/org-structure graph. One population; tags split by what you are doing, not who.\n\nBrowse the employee directory and view colleague profiles, photos and about-me content." }, { "name": "People Administration", "description": "Administer the employee population — bulk operations and company-individual records." }, { "name": "Teams", "description": "The core product — teams, connection measures, runs, questionnaires, 1:1 sessions and the org-level rollup.\n\nCreate and manage the teams that connection measures run against." }, { "name": "Behaviour", "description": "Instrument delivery and results. A master group with one tag per instrument — Behaviour today; Personality, EI and Aptitude in a later release.\n\nBehaviour instrument delivery, consent and results." }, { "name": "Assignments", "description": "Assign assessment instruments to individuals and track completion." }, { "name": "AI Coaching", "description": "The persistent AI coach — conversations, suggestion cards and team-session question generation.\n\nPersistent AI coaching conversations for an individual." } ], "servers": [ { "url": "https://api.thomas.co/v1" } ], "components": { "securitySchemes": { "bearer": { "scheme": "bearer", "bearerFormat": "JWT", "type": "http" } }, "schemas": { "ApiErrorResponseDto": { "type": "object", "properties": { "statusCode": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991, "description": "HTTP status code of the error", "examples": [ 400 ] }, "message": { "type": "string", "description": "human-readable error message", "examples": [ "Account not found" ] }, "error": { "type": "string", "description": "machine-readable error code", "examples": [ "IDENTITY_ACCOUNT_NOT_FOUND" ] }, "details": { "description": "additional error details for debugging", "type": "object", "propertyNames": { "type": "string" }, "additionalProperties": {} } }, "required": [ "statusCode", "message", "error" ] }, "ResolveIndividualDto": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "hrisId": { "type": "string", "minLength": 1 } } }, "ResolveIndividualResponseDto": { "type": "object", "properties": { "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "identifier of the resolved or created individual", "examples": [ "f47ac10b-58cc-4372-a567-0e02b2c3d479" ] }, "created": { "type": "boolean", "description": "whether a new individual was created during resolution", "examples": [ false ] } }, "required": [ "individualId", "created" ] }, "CreateColleagueDto": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "personalEmail": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "department": { "type": "string" }, "jobTitle": { "type": "string" }, "location": { "type": "string" } }, "required": [ "email" ] }, "ReactivateColleagueOfferDto": { "type": "object", "properties": { "classification": { "type": "string", "enum": [ "reactivate" ] }, "archivedProfile": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "firstName": { "type": "string", "nullable": true }, "lastName": { "type": "string", "nullable": true }, "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "status": { "type": "string", "enum": [ "pending", "active", "archived", "deletion_requested" ] } }, "required": [ "id", "individualId", "firstName", "lastName", "email", "status" ] } }, "required": [ "classification", "archivedProfile" ] }, "CreatedColleagueResponseDto": { "type": "object", "properties": { "classification": { "type": "string", "enum": [ "created" ] }, "companyIndividual": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "companyId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "hrisId": { "type": "string", "nullable": true }, "role": { "type": "string", "enum": [ "owner", "admin", "viewer" ] }, "relationshipType": { "type": "string", "enum": [ "candidate", "employee", "former_employee" ], "description": "type of relationship between the individual and the company" }, "status": { "type": "string", "enum": [ "pending", "active", "archived", "deletion_requested" ] }, "lifecycleStatus": { "type": "string", "enum": [ "active", "archived", "in_anonymisation", "tombstone" ] }, "membershipSuspendedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "nullable": true }, "sortFirstName": { "type": "string", "nullable": true }, "sortLastName": { "type": "string", "nullable": true }, "claimableIndividualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "nullable": true }, "confidential": { "type": "boolean" }, "directoryHidden": { "type": "boolean" }, "confidentialAccessGroupId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "nullable": true }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "individualId", "companyId", "tenantId", "hrisId", "role", "relationshipType", "status", "lifecycleStatus", "membershipSuspendedAt", "sortFirstName", "sortLastName", "claimableIndividualId", "confidential", "directoryHidden", "confidentialAccessGroupId", "createdAt", "updatedAt" ] } }, "required": [ "classification", "companyIndividual" ] }, "BulkValidateRequestDto": { "type": "object", "properties": { "rows": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "personalEmail": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "department": { "type": "string" }, "jobTitle": { "type": "string" }, "location": { "type": "string" } }, "required": [ "email" ] } } }, "required": [ "rows" ] }, "BulkValidateResponseDto": { "type": "object", "properties": { "results": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "classification": { "type": "string", "enum": [ "ready", "reactivate", "rejected" ] }, "reason": { "type": "string" }, "archivedProfile": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "firstName": { "type": "string", "nullable": true }, "lastName": { "type": "string", "nullable": true } }, "required": [ "id", "firstName", "lastName" ] } }, "required": [ "index", "email", "classification" ] } }, "summary": { "type": "object", "properties": { "ready": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "reactivate": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "rejected": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 } }, "required": [ "ready", "reactivate", "rejected" ] } }, "required": [ "results", "summary" ] }, "BulkCreateRequestDto": { "type": "object", "properties": { "rows": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "personalEmail": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "department": { "type": "string" }, "jobTitle": { "type": "string" }, "location": { "type": "string" }, "classification": { "type": "string", "enum": [ "ready", "reactivate" ] }, "archivedProfileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "required": [ "email", "classification" ] } } }, "required": [ "rows" ] }, "BulkCreateResponseDto": { "type": "object", "properties": { "created": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "reactivated": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "rejected": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "details": { "type": "array", "items": { "type": "object", "properties": { "index": { "type": "integer", "minimum": -9007199254740991, "maximum": 9007199254740991 }, "email": { "type": "string", "format": "email", "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$" }, "status": { "type": "string", "enum": [ "created", "reactivated", "rejected" ] }, "companyIndividualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "reason": { "type": "string" } }, "required": [ "index", "email", "status" ] } } }, "required": [ "created", "reactivated", "rejected", "details" ] }, "CreateConversationBodyDto": { "type": "object", "properties": { "contextTag": { "type": "string", "enum": [ "personal", "manager", "org_analyst" ] }, "entryPoint": { "type": "string", "enum": [ "thomai_card", "persistent_button", "thomai_fab", "prompt_card", "input_bar", "unprompted" ] }, "pageId": { "type": "string", "enum": [ "individual", "team", "org_analyst", "manager", "home", "unprompted", "connection_template1_results" ] }, "title": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "contextTag", "entryPoint" ], "additionalProperties": false }, "ConversationResponseDto": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextTag": { "type": "string", "enum": [ "personal", "manager", "org_analyst" ] }, "entryPoint": { "type": "string", "minLength": 1 }, "pageId": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "lastMessageAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "contextTag", "entryPoint", "pageId", "title", "lastMessageAt", "createdAt", "updatedAt" ], "additionalProperties": false }, "ConversationsListResponseDto": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contextTag": { "type": "string", "enum": [ "personal", "manager", "org_analyst" ] }, "entryPoint": { "type": "string", "minLength": 1 }, "pageId": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "lastMessageAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "contextTag", "entryPoint", "pageId", "title", "createdAt", "lastMessageAt" ], "additionalProperties": false } }, "nextCursor": { "type": "string", "nullable": true } }, "required": [ "items", "nextCursor" ], "additionalProperties": false }, "ConnectionPowerResponseDto": { "type": "object", "properties": { "connectionPowerType": { "type": "string", "enum": [ "action", "energy", "stability", "precision" ], "nullable": true }, "assessmentCompletedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "nullable": true } }, "required": [ "connectionPowerType", "assessmentCompletedAt" ] }, "BehaviourProfileResponseDto": { "type": "object", "properties": { "connectionPowerType": { "type": "string", "enum": [ "action", "energy", "stability", "precision" ] }, "traitSpectrums": { "minItems": 4, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "dimension": { "type": "string", "enum": [ "D", "I", "S", "C" ] }, "name": { "type": "string", "minLength": 1 }, "leftPole": { "type": "string", "minLength": 1 }, "rightPole": { "type": "string", "minLength": 1 }, "position": { "type": "integer", "minimum": 0, "maximum": 100 }, "band": { "type": "string", "enum": [ "VeryHigh", "High", "Low", "VeryLow" ], "description": "Behaviour band per facet, derived from raw combined score per legacy spec §3.1" } }, "required": [ "dimension", "name", "leftPole", "rightPole", "position", "band" ] } }, "selfImageScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "i": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "s": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "c": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "d", "i", "s", "c" ] }, "scoredAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "soloInsights": { "type": "array", "items": { "type": "object", "properties": { "topic": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "slug": { "type": "string", "minLength": 1 }, "label": { "type": "string", "minLength": 1 }, "sortOrder": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "assessmentType", "slug", "label", "sortOrder", "createdAt", "updatedAt" ] }, "entries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "topicId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "contentType": { "type": "string", "minLength": 1 }, "mappingKey": { "type": "string", "minLength": 1 }, "mappingGranularity": { "type": "string", "enum": [ "profile", "quadrant", "trait", "trait_pair", "topic" ] }, "title": { "type": "string", "minLength": 1 }, "body": { "type": "string", "minLength": 1 }, "sortOrder": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "id", "topicId", "contentType", "mappingKey", "mappingGranularity", "title", "body", "sortOrder", "createdAt", "updatedAt" ] } } }, "required": [ "topic", "entries" ] } }, "discAdvanced": { "type": "object", "properties": { "workMaskScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "i": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "s": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "c": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "d", "i", "s", "c" ] }, "underPressureScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "i": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "s": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "c": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "d", "i", "s", "c" ] } }, "required": [ "workMaskScores", "underPressureScores" ], "additionalProperties": false } }, "required": [ "connectionPowerType", "traitSpectrums", "selfImageScores", "scoredAt", "soloInsights" ], "additionalProperties": false }, "CreateAssignmentRequestDto": { "type": "object", "properties": { "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "individualId", "assessmentType" ] }, "AssignmentResponseDto": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "assignedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "nullable": true }, "status": { "type": "string", "enum": [ "PENDING", "COMPLETED", "EXPIRED" ] }, "resultId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "nullable": true }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accessToken": { "type": "string" }, "created": { "type": "boolean" } }, "required": [ "id", "tenantId", "individualId", "assessmentType", "assignedBy", "assignedAt", "status", "createdAt", "updatedAt" ] }, "BulkCreateAssignmentRequestDto": { "type": "object", "properties": { "individualIds": { "minItems": 1, "maxItems": 100, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" } }, "required": [ "individualIds", "assessmentType" ] }, "BulkAssignmentResponseDto": { "type": "object", "properties": { "created": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "skipped": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "results": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "assignedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "nullable": true }, "status": { "type": "string", "enum": [ "PENDING", "COMPLETED", "EXPIRED" ] }, "resultId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "nullable": true }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accessToken": { "type": "string" }, "created": { "type": "boolean" } }, "required": [ "id", "tenantId", "individualId", "assessmentType", "assignedBy", "assignedAt", "status", "createdAt", "updatedAt" ] } } }, "required": [ "created", "skipped", "results" ] }, "AssignmentListResponseDto": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "assignedBy": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, "assignedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "nullable": true }, "status": { "type": "string", "enum": [ "PENDING", "COMPLETED", "EXPIRED" ] }, "resultId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "nullable": true }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, "accessToken": { "type": "string" }, "created": { "type": "boolean" } }, "required": [ "id", "tenantId", "individualId", "assessmentType", "assignedBy", "assignedAt", "status", "createdAt", "updatedAt" ] } }, "total": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 } }, "required": [ "data", "total" ] }, "CreateExplicitTeamDto": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 100, "description": "team display name", "examples": [ "My Project Team" ] }, "memberIndividualIds": { "description": "individual IDs of initial team members (role=member)", "examples": [ [ "b2c3d4e5-f6a7-8901-bcde-f12345678901" ] ], "maxItems": 200, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "ownerIndividualIds": { "description": "individual IDs of additional team owners beyond the creator", "examples": [ [ "c3d4e5f6-a7b8-9012-cdef-123456789012" ] ], "maxItems": 50, "type": "array", "items": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" } }, "visibility": { "type": "string", "enum": [ "visible", "hidden" ], "description": "team visibility setting", "examples": [ "visible" ] } }, "required": [ "name" ] }, "TeamWithMembersResponseDto": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "team identifier", "examples": [ "f47ac10b-58cc-4372-a567-0e02b2c3d479" ] }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "tenant identifier", "examples": [ "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ] }, "name": { "type": "string", "description": "team display name", "examples": [ "Alice Smith's team" ] }, "teamType": { "type": "string", "enum": [ "implicit", "explicit" ], "description": "type of team — implicit (from org hierarchy) or explicit (user-created)", "examples": [ "implicit" ] }, "sourceManagerIndividualId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ], "description": "manager individual ID for implicit teams", "examples": [ "b2c3d4e5-f6a7-8901-bcde-f12345678901" ] }, "visibility": { "type": "string", "enum": [ "visible", "hidden" ], "description": "team visibility setting", "examples": [ "visible" ] }, "firstSharedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ], "description": "timestamp the team was first shared (visibility flipped to visible) — null until first share, immutable thereafter", "examples": [ null ] }, "needsOwnerAssignment": { "type": "boolean", "description": "whether the team currently has no active owner and needs reassignment", "examples": [ false ] }, "deletedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ], "description": "soft delete timestamp", "examples": [ null ] }, "inactiveAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ], "description": "timestamp when team became inactive (all members archived)", "examples": [ null ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "description": "creation timestamp", "examples": [ "2026-01-15T10:30:00.000Z" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "description": "last update timestamp", "examples": [ "2026-01-15T10:30:00.000Z" ] }, "members": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "team-member row identifier", "examples": [ "d4e5f6a7-b8c9-4012-8def-234567890123" ] }, "teamId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "team identifier", "examples": [ "f47ac10b-58cc-4372-a567-0e02b2c3d479" ] }, "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "individual identifier", "examples": [ "b2c3d4e5-f6a7-8901-bcde-f12345678901" ] }, "companyIndividualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "company individual identifier", "examples": [ "c3d4e5f6-a7b8-9012-cdef-123456789012" ] }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "tenant identifier", "examples": [ "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ] }, "role": { "type": "string", "enum": [ "owner", "member" ], "description": "role of a team member", "examples": [ "owner" ] }, "status": { "type": "string", "enum": [ "pending", "active", "archived", "deletion_requested" ], "description": "company-individual lifecycle status of this member — `active` owners are the ones that count toward the sole-host / orphan-detection guards (THO-1129)", "examples": [ "active" ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "description": "creation timestamp", "examples": [ "2026-01-15T10:30:00.000Z" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "description": "last update timestamp", "examples": [ "2026-01-15T10:30:00.000Z" ] } }, "required": [ "id", "teamId", "individualId", "companyIndividualId", "tenantId", "role", "status", "createdAt", "updatedAt" ] }, "description": "team members including owners" } }, "required": [ "id", "tenantId", "name", "teamType", "sourceManagerIndividualId", "visibility", "firstSharedAt", "needsOwnerAssignment", "deletedAt", "inactiveAt", "createdAt", "updatedAt", "members" ] }, "ListConnectionTeamsResponseDto": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "team identifier", "examples": [ "f47ac10b-58cc-4372-a567-0e02b2c3d479" ] }, "tenantId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "tenant identifier", "examples": [ "a1b2c3d4-e5f6-7890-abcd-ef1234567890" ] }, "name": { "type": "string", "description": "team display name", "examples": [ "Alice Smith's team" ] }, "teamType": { "type": "string", "enum": [ "implicit", "explicit" ], "description": "type of team — implicit (from org hierarchy) or explicit (user-created)", "examples": [ "implicit" ] }, "sourceManagerIndividualId": { "anyOf": [ { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$" }, { "type": "null" } ], "description": "manager individual ID for implicit teams", "examples": [ "b2c3d4e5-f6a7-8901-bcde-f12345678901" ] }, "visibility": { "type": "string", "enum": [ "visible", "hidden" ], "description": "team visibility setting", "examples": [ "visible" ] }, "firstSharedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ], "description": "timestamp the team was first shared (visibility flipped to visible) — null until first share, immutable thereafter", "examples": [ null ] }, "needsOwnerAssignment": { "type": "boolean", "description": "whether the team currently has no active owner and needs reassignment", "examples": [ false ] }, "deletedAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ], "description": "soft delete timestamp", "examples": [ null ] }, "inactiveAt": { "anyOf": [ { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$" }, { "type": "null" } ], "description": "timestamp when team became inactive (all members archived)", "examples": [ null ] }, "createdAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "description": "creation timestamp", "examples": [ "2026-01-15T10:30:00.000Z" ] }, "updatedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$", "description": "last update timestamp", "examples": [ "2026-01-15T10:30:00.000Z" ] } }, "required": [ "id", "tenantId", "name", "teamType", "sourceManagerIndividualId", "visibility", "firstSharedAt", "needsOwnerAssignment", "deletedAt", "inactiveAt", "createdAt", "updatedAt" ] } }, "TeamDynamicsResponseDto": { "type": "object", "properties": { "teamId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "team identifier", "examples": [ "f47ac10b-58cc-4372-a567-0e02b2c3d479" ] }, "members": { "type": "array", "items": { "type": "object", "properties": { "individualId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "individual identifier of the team member", "examples": [ "b2c3d4e5-f6a7-8901-bcde-f12345678901" ] }, "displayName": { "type": "string", "minLength": 1, "description": "first name of the team member for display in the People panel", "examples": [ "Alice" ] }, "connectionPower": { "anyOf": [ { "type": "string", "enum": [ "action", "energy", "stability", "precision" ], "description": "behavioural archetype used for colour-coding connection powers", "examples": [ "action" ] }, { "type": "null" } ], "description": "dominant connection power — null when unassessed", "examples": [ "energy" ] }, "behaviourScales": { "anyOf": [ { "type": "object", "properties": { "accommodatingDirect": { "type": "number", "minimum": 0, "maximum": 100, "description": "bipolar scale: Accommodating (0) to Direct (100)", "examples": [ 72 ] }, "reflectiveOutgoing": { "type": "number", "minimum": 0, "maximum": 100, "description": "bipolar scale: Reflective (0) to Outgoing (100)", "examples": [ 45 ] }, "spontaneousMethodical": { "type": "number", "minimum": 0, "maximum": 100, "description": "bipolar scale: Spontaneous (0) to Methodical (100)", "examples": [ 88 ] }, "pragmaticPerfectionist": { "type": "number", "minimum": 0, "maximum": 100, "description": "bipolar scale: Pragmatic (0) to Perfectionist (100)", "examples": [ 33 ] } }, "required": [ "accommodatingDirect", "reflectiveOutgoing", "spontaneousMethodical", "pragmaticPerfectionist" ] }, { "type": "null" } ], "description": "four bipolar dimension scale scores — null when unassessed", "examples": [ null ] }, "assessmentStatus": { "type": "string", "enum": [ "assessed", "unassessed" ], "description": "whether this member has completed their assessment", "examples": [ "assessed" ] } }, "required": [ "individualId", "displayName", "connectionPower", "behaviourScales", "assessmentStatus" ] }, "description": "all team members regardless of assessment status", "examples": [ [] ] }, "powerDistribution": { "type": "object", "properties": { "action": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "count of assessed members with action power", "examples": [ 3 ] }, "energy": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "count of assessed members with energy power", "examples": [ 2 ] }, "stability": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "count of assessed members with stability power", "examples": [ 4 ] }, "precision": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "count of assessed members with precision power", "examples": [ 1 ] } }, "required": [ "action", "energy", "stability", "precision" ], "description": "count of assessed members per connection power", "examples": [ { "action": 3, "energy": 2, "stability": 4, "precision": 1 } ] }, "dominantPower": { "anyOf": [ { "type": "string", "enum": [ "action", "energy", "stability", "precision" ], "description": "behavioural archetype used for colour-coding connection powers", "examples": [ "action" ] }, { "type": "null" } ], "description": "most common power — null when no assessed members; tie-break falls back to action", "examples": [ "stability" ] }, "narrativeContent": { "anyOf": [ { "type": "object", "properties": { "body": { "type": "string", "description": "narrative text with embedded token placeholders", "examples": [ "%firstName, your team shows a strong preference for action." ] }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "description": "token placeholder in narrative body (e.g. %firstName)", "examples": [ "%firstName" ] }, "value": { "type": "string", "description": "runtime replacement value for the token", "examples": [ "Alice" ] } }, "required": [ "key", "value" ] }, "description": "list of token key/value pairs for runtime replacement", "examples": [ [ { "key": "%firstName", "value": "Alice" } ] ] } }, "required": [ "body", "tokens" ] }, { "type": "null" } ], "description": "personalised narrative — null when insufficient data", "examples": [ null ] }, "strengthsAndWatchouts": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "strength", "watchout" ], "description": "discriminator for strength vs watch-out styling", "examples": [ "strength" ] }, "title": { "type": "string", "description": "card heading", "examples": [ "High Energy Collaboration" ] }, "description": { "type": "string", "description": "card body text", "examples": [ "Your team thrives on energetic discussion and quick decision-making." ] }, "narrativeContent": { "anyOf": [ { "type": "object", "properties": { "body": { "type": "string", "description": "narrative text with embedded token placeholders", "examples": [ "%firstName, your team shows a strong preference for action." ] }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "description": "token placeholder in narrative body (e.g. %firstName)", "examples": [ "%firstName" ] }, "value": { "type": "string", "description": "runtime replacement value for the token", "examples": [ "Alice" ] } }, "required": [ "key", "value" ] }, "description": "list of token key/value pairs for runtime replacement", "examples": [ [ { "key": "%firstName", "value": "Alice" } ] ] } }, "required": [ "body", "tokens" ] }, { "type": "null" } ], "description": "optional personalised narrative with runtime tokens", "examples": [ null ] } }, "required": [ "type", "title", "description", "narrativeContent" ] }, "description": "strength and watch-out cards — may be empty array", "examples": [ [] ] }, "scaleDescriptions": { "anyOf": [ { "type": "object", "properties": { "accommodatingDirect": { "anyOf": [ { "type": "object", "properties": { "body": { "type": "string", "description": "narrative text with embedded token placeholders", "examples": [ "%firstName, your team shows a strong preference for action." ] }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "description": "token placeholder in narrative body (e.g. %firstName)", "examples": [ "%firstName" ] }, "value": { "type": "string", "description": "runtime replacement value for the token", "examples": [ "Alice" ] } }, "required": [ "key", "value" ] }, "description": "list of token key/value pairs for runtime replacement", "examples": [ [ { "key": "%firstName", "value": "Alice" } ] ] } }, "required": [ "body", "tokens" ] }, { "type": "null" } ], "description": "narrative for the Accommodating↔Direct scale — null when no content entry exists", "examples": [ null ] }, "reflectiveOutgoing": { "anyOf": [ { "type": "object", "properties": { "body": { "type": "string", "description": "narrative text with embedded token placeholders", "examples": [ "%firstName, your team shows a strong preference for action." ] }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "description": "token placeholder in narrative body (e.g. %firstName)", "examples": [ "%firstName" ] }, "value": { "type": "string", "description": "runtime replacement value for the token", "examples": [ "Alice" ] } }, "required": [ "key", "value" ] }, "description": "list of token key/value pairs for runtime replacement", "examples": [ [ { "key": "%firstName", "value": "Alice" } ] ] } }, "required": [ "body", "tokens" ] }, { "type": "null" } ], "description": "narrative for the Reflective↔Outgoing scale — null when no content entry exists", "examples": [ null ] }, "spontaneousMethodical": { "anyOf": [ { "type": "object", "properties": { "body": { "type": "string", "description": "narrative text with embedded token placeholders", "examples": [ "%firstName, your team shows a strong preference for action." ] }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "description": "token placeholder in narrative body (e.g. %firstName)", "examples": [ "%firstName" ] }, "value": { "type": "string", "description": "runtime replacement value for the token", "examples": [ "Alice" ] } }, "required": [ "key", "value" ] }, "description": "list of token key/value pairs for runtime replacement", "examples": [ [ { "key": "%firstName", "value": "Alice" } ] ] } }, "required": [ "body", "tokens" ] }, { "type": "null" } ], "description": "narrative for the Spontaneous↔Methodical scale — null when no content entry exists", "examples": [ null ] }, "pragmaticPerfectionist": { "anyOf": [ { "type": "object", "properties": { "body": { "type": "string", "description": "narrative text with embedded token placeholders", "examples": [ "%firstName, your team shows a strong preference for action." ] }, "tokens": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string", "minLength": 1, "description": "token placeholder in narrative body (e.g. %firstName)", "examples": [ "%firstName" ] }, "value": { "type": "string", "description": "runtime replacement value for the token", "examples": [ "Alice" ] } }, "required": [ "key", "value" ] }, "description": "list of token key/value pairs for runtime replacement", "examples": [ [ { "key": "%firstName", "value": "Alice" } ] ] } }, "required": [ "body", "tokens" ] }, { "type": "null" } ], "description": "narrative for the Pragmatic↔Perfectionist scale — null when no content entry exists", "examples": [ null ] } }, "required": [ "accommodatingDirect", "reflectiveOutgoing", "spontaneousMethodical", "pragmaticPerfectionist" ] }, { "type": "null" } ], "description": "per-scale personalised narratives — null when content is entirely missing", "examples": [ null ] } }, "required": [ "teamId", "members", "powerDistribution", "dominantPower", "narrativeContent", "strengthsAndWatchouts", "scaleDescriptions" ] } } }, "security": [ { "bearer": [] } ], "x-tagGroups": [ { "name": "People", "description": "The employee population — directory, profiles, administration, roles and the manager/org-structure graph. One population; tags split by what you are doing, not who.", "tags": [ "Colleagues & Profiles", "People Administration" ] }, { "name": "Connection", "description": "The core product — teams, connection measures, runs, questionnaires, 1:1 sessions and the org-level rollup.", "tags": [ "Teams" ] }, { "name": "Assessments", "description": "Instrument delivery and results. A master group with one tag per instrument — Behaviour today; Personality, EI and Aptitude in a later release.", "tags": [ "Behaviour", "Assignments" ] }, { "name": "Coaching (ThomAI)", "description": "The persistent AI coach — conversations, suggestion cards and team-session question generation.", "tags": [ "AI Coaching" ] } ] }