{ "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. A Partner API client that is the tenant's active `users` source of record calls the same operation, supplying `partnerReference`, `sourceVersion` and an optional `hrisId` instead of the human-entered `firstName`, `lastName`, `personalEmail`, `department`, `jobTitle` and `location` — each caller kind is rejected with a 400 if it sends the other kind's fields, and the role may never be supplied by either. For that Partner caller only, an `email` or `hrisId` resolving to an employee the tenant ALREADY has returns 200 with `classification: \"reconciled\"`: the reference is linked to that existing colleague, whose role, membership and creator provenance are all preserved, and nothing new is created. A human caller never receives that classification — a human create resolving to an existing active employee is still a 409 duplicate.", "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\"); or, for a Partner API client, the existing colleague its reference was linked to (classification: \"reconciled\")", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ReactivateColleagueOfferDto" }, { "$ref": "#/components/schemas/ReconciledColleagueResponseDto" } ] } } } }, "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 (AUTH_INSUFFICIENT_ROLE); for an API client, no active Grant carrying `users:w` on this tenant (AUTH_TENANT_NOT_GRANTED) or not the tenant's active `users` source of record (AUTH_SOURCE_OF_RECORD_REQUIRED)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "Insufficient role privileges", "error": "AUTH_INSUFFICIENT_ROLE" } } } }, "409": { "description": "Already an employee of this tenant (DUPLICATE_EMAIL); the supplied reference, email and `hrisId` do not all name the same person (IDENTITY_RESOLUTION_CONFLICT); or this API client already holds a different reference for that employee (PARTNER_EMPLOYEE_REFERENCE_CONFLICT)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 409, "message": "A colleague with this email already exists", "error": "DUPLICATE_EMAIL" } } } }, "429": { "description": "Rate limit exceeded.", "headers": { "Retry-After": { "description": "Seconds until the rate-limit block expires before retrying.", "schema": { "type": "integer", "minimum": 0 } }, "RateLimit-Limit": { "description": "Configured request limit for the active rate-limit window.", "schema": { "type": "integer" } }, "RateLimit-Remaining": { "description": "Requests remaining in the active rate-limit window; zero when blocked.", "schema": { "type": "integer" } }, "RateLimit-Reset": { "description": "Seconds until the rate-limit block expires.", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 429, "message": "ThrottlerException: Too Many Requests", "error": "HTTP_TOO_MANY_REQUESTS" } } } } }, "summary": "Create a colleague profile", "tags": [ "People Administration" ], "x-badges": [ { "name": "Admin" }, { "name": "Owner" } ] } }, "/colleagues/{id}": { "get": { "description": "Returns a full profile with identity, membership history, manager links, audit summary, and enrichment placeholders. personalEmail is included for Admin/Owner roles or when the caller reads their own record; a non-self Viewer gets null. **`{id}` is interpreted by CALLER KIND, never by the value's shape.** For a human caller it is the Thomas colleague id (a UUID) and the response is the profile detail above. For a Partner API client that is the tenant's active `users` source of record it is that client's OWN opaque `partnerReference`, resolved only within its own tenant/API-client namespace, and the response is the partner employee projection. The same opaque value under another API client or another tenant is a different colleague and is never returned. Partner references are opaque and may legitimately be UUID-shaped; that is why the caller kind, and not the value, selects the interpretation.", "operationId": "getColleague", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Full colleague profile detail for a human caller; the partner employee projection for a Partner API client reading by its own reference", "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/CompanyIndividualDetailResponseDto" }, { "$ref": "#/components/schemas/PartnerEmployeeResponseDto" } ] } } } }, "400": { "description": "Invalid UUID format for id parameter, or malformed partner reference", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" } } } }, "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": "For an API client: not the tenant's active `users` source of record (AUTH_SOURCE_OF_RECORD_REQUIRED), no active Grant carrying `users:r` on this tenant (AUTH_TENANT_NOT_GRANTED), or a caller whose kind this operation could not resolve", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 403, "message": "API client is not the source of record for this data domain in this tenant", "error": "AUTH_SOURCE_OF_RECORD_REQUIRED" } } } }, "404": { "description": "Colleague not found (IDENTITY_COMPANY_INDIVIDUAL_NOT_FOUND), or no colleague in this tenant/API-client namespace (PARTNER_EMPLOYEE_NOT_FOUND)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" } } } }, "429": { "description": "Rate limit exceeded.", "headers": { "Retry-After": { "description": "Seconds until the rate-limit block expires before retrying.", "schema": { "type": "integer", "minimum": 0 } }, "RateLimit-Limit": { "description": "Configured request limit for the active rate-limit window.", "schema": { "type": "integer" } }, "RateLimit-Remaining": { "description": "Requests remaining in the active rate-limit window; zero when blocked.", "schema": { "type": "integer" } }, "RateLimit-Reset": { "description": "Seconds until the rate-limit block expires.", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 429, "message": "ThrottlerException: Too Many Requests", "error": "HTTP_TOO_MANY_REQUESTS" } } } } }, "summary": "Get colleague profile detail", "tags": [ "Colleagues & Profiles" ], "x-badges": [ { "name": "Viewer" }, { "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" } } } }, "429": { "description": "Rate limit exceeded.", "headers": { "Retry-After": { "description": "Seconds until the rate-limit block expires before retrying.", "schema": { "type": "integer", "minimum": 0 } }, "RateLimit-Limit": { "description": "Configured request limit for the active rate-limit window.", "schema": { "type": "integer" } }, "RateLimit-Remaining": { "description": "Requests remaining in the active rate-limit window; zero when blocked.", "schema": { "type": "integer" } }, "RateLimit-Reset": { "description": "Seconds until the rate-limit block expires.", "schema": { "type": "integer", "minimum": 0 } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiErrorResponseDto" }, "example": { "statusCode": 429, "message": "ThrottlerException: Too Many Requests", "error": "HTTP_TOO_MANY_REQUESTS" } } } } }, "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": "Refused for one of two reasons: the tenant’s effective plan tier does not include the capability the requested instrument belongs to (envelope `INSUFFICIENT_TIER`, decided first, and applying to any caller) — or insufficient role, owner or admin required for cross-user assignment (envelope `AUTH_INSUFFICIENT_ROLE`).", "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": "Refused for one of two reasons: insufficient role, owner or admin required (envelope `AUTH_INSUFFICIENT_ROLE`, decided first because the role guard is global); or the tenant’s effective plan tier does not include the capability the requested instrument belongs to (envelope `INSUFFICIENT_TIER`).", "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://staging-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" ] }, "PartnerEmployeeResponseDto": { "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": "the stable global Individual this reference resolves to" }, "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": "the tenant-scoped employee relationship row" }, "partnerReference": { "type": "string", "minLength": 1, "maxLength": 255, "description": "the Partner's own opaque stable reference for this person", "examples": [ "worker-uk-004271" ] }, "sourceVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "the Partner's own non-negative version of the asserted record", "examples": [ 0, 42 ] }, "role": { "type": "string", "enum": [ "owner", "admin", "viewer" ], "description": "the employee's role as Thomas holds it — `viewer` on one this Partner created, and the existing Owner/Admin/Viewer on one it reconciled with. Never caller-supplied." }, "source": { "type": "string", "enum": [ "manual", "csv_import", "hris_sync", "partner_api" ], "description": "the membership's own source — `partner_api` on an employee this Partner created, and the original source on one it reconciled with" }, "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": "the Tenant this employee belongs to" }, "membershipId": { "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": "the membership row this Partner reference is bound to, whatever its source" }, "relationshipType": { "type": "string", "description": "always `employee` on this surface", "enum": [ "employee" ] } }, "required": [ "individualId", "companyIndividualId", "partnerReference", "sourceVersion", "role", "source", "tenantId", "membershipId", "relationshipType" ], "additionalProperties": false }, "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" ] }, "ReconciledColleagueResponseDto": { "type": "object", "properties": { "classification": { "type": "string", "enum": [ "reconciled" ] }, "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 }, "accessKind": { "type": "string", "enum": [ "colleague", "service", "integrations_admin" ] }, "accredited": { "type": "boolean" }, "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", "accessKind", "accredited", "createdAt", "updatedAt" ] } }, "required": [ "classification", "companyIndividual" ] }, "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" }, "partnerReference": { "type": "string", "minLength": 1, "maxLength": 255, "description": "the Partner's own opaque stable reference for this person", "examples": [ "worker-uk-004271" ] }, "sourceVersion": { "type": "integer", "minimum": 0, "maximum": 9007199254740991, "description": "the Partner's own non-negative version of the asserted record", "examples": [ 0, 42 ] }, "hrisId": { "type": "string", "minLength": 1, "maxLength": 255, "description": "the customer HR system's identifier for this person, scoped to the Tenant", "examples": [ "EMP-0099214" ] } }, "required": [ "email" ], "additionalProperties": false }, "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 }, "accessKind": { "type": "string", "enum": [ "colleague", "service", "integrations_admin" ] }, "accredited": { "type": "boolean" }, "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", "accessKind", "accredited", "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" ] }, "CompanyIndividualDetailResponseDto": { "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)$" }, "relationshipType": { "type": "string", "enum": [ "candidate", "employee", "former_employee" ], "description": "type of relationship between the individual and the company" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "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" ] }, "role": { "type": "string", "enum": [ "owner", "admin", "viewer" ] }, "department": { "type": "string", "nullable": true }, "location": { "type": "string", "nullable": true }, "jobTitle": { "type": "string", "nullable": true }, "photoHash": { "type": "string", "nullable": true }, "managerId": { "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 }, "managerName": { "type": "string", "nullable": true }, "directReportCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "invitationStatus": { "type": "string", "enum": [ "not_invited", "invited", "expired" ], "nullable": true }, "assessmentStatus": { "type": "string", "enum": [ "not_assigned", "assigned", "completed" ], "nullable": true }, "personalityAssessmentStatus": { "type": "string", "enum": [ "not_assigned", "assigned", "completed" ], "nullable": true }, "connectionPowerType": { "type": "string", "enum": [ "action", "energy", "stability", "precision" ], "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))$" }, "aggregateStatus": { "type": "string", "enum": [ "not_started", "invited", "in_progress", "completed" ], "description": "Candidate Aggregate status (FR-2): a single rolled-up status derived across in-scope per-assessment statuses. This same value set is also the per-assessment status vocabulary.", "nullable": true }, "connectionPowerRevealed": { "type": "boolean" }, "assessmentStatuses": { "type": "array", "items": { "type": "object", "properties": { "assessmentType": { "type": "string", "enum": [ "behaviour", "personality" ] }, "status": { "type": "string", "enum": [ "not_started", "invited", "in_progress", "completed" ], "description": "Candidate Aggregate status (FR-2): a single rolled-up status derived across in-scope per-assessment statuses. This same value set is also the per-assessment status vocabulary." }, "hasResult": { "type": "boolean" } }, "required": [ "assessmentType", "status", "hasResult" ] } }, "confidential": { "type": "boolean" }, "confidentialCircle": { "type": "object", "properties": { "memberCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "viewerInCircle": { "type": "boolean" } }, "required": [ "memberCount", "viewerInCircle" ], "nullable": true }, "directoryHidden": { "type": "boolean" }, "hrisId": { "type": "string", "nullable": true }, "personalEmail": { "type": "string", "nullable": true }, "isManager": { "default": false, "type": "boolean" }, "memberships": { "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)$" }, "department": { "type": "string", "nullable": true }, "location": { "type": "string", "nullable": true }, "jobTitle": { "type": "string", "nullable": true }, "effectiveFrom": { "type": "string", "format": "date", "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])))$", "nullable": true }, "effectiveTo": { "type": "string", "format": "date", "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])))$", "nullable": true }, "source": { "type": "string", "enum": [ "manual", "csv_import", "hris_sync", "partner_api" ], "description": "source of the membership record" } }, "required": [ "id", "department", "location", "jobTitle", "effectiveFrom", "effectiveTo", "source" ] } }, "managerLinks": { "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)$" }, "managerIndividualId": { "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)$" }, "reportIndividualId": { "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)$" }, "effectiveFrom": { "type": "string", "format": "date", "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])))$", "nullable": true }, "effectiveTo": { "type": "string", "format": "date", "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])))$", "nullable": true } }, "required": [ "id", "managerIndividualId", "reportIndividualId", "effectiveFrom", "effectiveTo" ] } }, "pendingChange": { "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)$" }, "department": { "type": "string", "nullable": true }, "location": { "type": "string", "nullable": true }, "jobTitle": { "type": "string", "nullable": true }, "effectiveFrom": { "type": "string", "format": "date", "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])))$", "nullable": true }, "effectiveTo": { "type": "string", "format": "date", "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])))$", "nullable": true }, "source": { "type": "string", "enum": [ "manual", "csv_import", "hris_sync", "partner_api" ], "description": "source of the membership record" } }, "required": [ "id", "department", "location", "jobTitle", "effectiveFrom", "effectiveTo", "source" ], "nullable": true }, "photoUrl": { "type": "string", "nullable": true }, "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))$" }, "auditSummary": { "type": "object", "properties": { "lastAction": { "type": "string", "nullable": true }, "lastActionAt": { "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": [ "lastAction", "lastActionAt" ] }, "connectionScore": { "type": "number", "nullable": true }, "behaviourProfile": { "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": 1000 }, "i": { "type": "integer", "minimum": 0, "maximum": 1000 }, "s": { "type": "integer", "minimum": 0, "maximum": 1000 }, "c": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "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))$" }, "discAdvanced": { "type": "object", "properties": { "workMaskScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 1000 }, "i": { "type": "integer", "minimum": 0, "maximum": 1000 }, "s": { "type": "integer", "minimum": 0, "maximum": 1000 }, "c": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "required": [ "d", "i", "s", "c" ] }, "underPressureScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 1000 }, "i": { "type": "integer", "minimum": 0, "maximum": 1000 }, "s": { "type": "integer", "minimum": 0, "maximum": 1000 }, "c": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "required": [ "d", "i", "s", "c" ] } }, "required": [ "workMaskScores", "underPressureScores" ], "additionalProperties": false } }, "required": [ "connectionPowerType", "traitSpectrums", "selfImageScores", "scoredAt" ], "additionalProperties": false, "nullable": true }, "canViewBehaviour": { "type": "boolean" }, "canViewBehaviourByRole": { "type": "boolean" }, "canViewBehaviourByRoleUnresolved": { "type": "boolean" }, "personalisedInsights": { "nullable": true }, "transferredReports": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "demographics": { "type": "object", "properties": { "yearOfBirth": { "type": "integer", "minimum": 1900, "maximum": 2100, "nullable": true }, "country": { "type": "string", "nullable": true }, "education": { "type": "string", "nullable": true }, "managementLevel": { "type": "string", "nullable": true }, "gender": { "type": "string", "nullable": true }, "industry": { "type": "string", "nullable": true }, "workType": { "type": "string", "nullable": true }, "nativeLanguage": { "type": "string", "enum": [ "Abkhazian", "Afar", "Afrikaans", "Akan", "Albanian", "Amharic", "Arabic", "Aragonese", "Armenian", "Assamese", "Avaric", "Avestan", "Aymara", "Azerbaijani", "Bambara", "Bashkir", "Basque", "Belarusian", "Bengali", "Bihari languages", "Bislama", "Bosnian", "Breton", "Bulgarian", "Burmese", "Catalan", "Central Khmer", "Chamorro", "Chechen", "Chichewa", "Chinese", "Church Slavic", "Chuvash", "Cornish", "Corsican", "Cree", "Croatian", "Czech", "Danish", "Divehi", "Dutch", "Dzongkha", "English", "Esperanto", "Estonian", "Ewe", "Faroese", "Fijian", "Finnish", "French", "Fulah", "Gaelic", "Galician", "Ganda", "Georgian", "German", "Greek", "Guarani", "Gujarati", "Haitian", "Hausa", "Hebrew", "Herero", "Hindi", "Hiri Motu", "Hungarian", "Icelandic", "Ido", "Igbo", "Indonesian", "Interlingua", "Interlingue", "Inuktitut", "Inupiaq", "Irish", "Italian", "Japanese", "Javanese", "Kalaallisut", "Kannada", "Kanuri", "Kashmiri", "Kazakh", "Kikuyu", "Kinyarwanda", "Kirghiz", "Komi", "Kongo", "Korean", "Kuanyama", "Kurdish", "Lao", "Latin", "Latvian", "Limburgish", "Lingala", "Lithuanian", "Luba-Katanga", "Luxembourgish", "Macedonian", "Malagasy", "Malay", "Malayalam", "Maltese", "Manx", "Maori", "Marathi", "Marshallese", "Mongolian", "Nauru", "Navajo", "Ndonga", "Nepali", "North Ndebele", "Northern Sami", "Norwegian", "Norwegian Bokmål", "Norwegian Nynorsk", "Occitan", "Ojibwa", "Oriya", "Oromo", "Ossetian", "Pali", "Pashto", "Persian", "Polish", "Portuguese", "Punjabi", "Quechua", "Romanian", "Romansh", "Rundi", "Russian", "Samoan", "Sango", "Sanskrit", "Sardinian", "Serbian", "Shona", "Sichuan Yi", "Sindhi", "Sinhala", "Slovak", "Slovenian", "Somali", "South Ndebele", "Southern Sotho", "Spanish", "Sundanese", "Swahili", "Swati", "Swedish", "Tagalog", "Tahitian", "Tajik", "Tamil", "Tatar", "Telugu", "Thai", "Tibetan", "Tigrinya", "Tonga", "Tsonga", "Tswana", "Turkish", "Turkmen", "Twi", "Uighur", "Ukrainian", "Urdu", "Uzbek", "Venda", "Vietnamese", "Volapük", "Walloon", "Welsh", "Western Frisian", "Wolof", "Xhosa", "Yiddish", "Yoruba", "Zhuang", "Zulu" ], "nullable": true } }, "required": [ "yearOfBirth", "country", "education", "managementLevel", "gender", "industry", "workType", "nativeLanguage" ], "nullable": true }, "demographicsSurvey": { "type": "object", "properties": { "surveyState": { "type": "string", "enum": [ "skipped", "complete" ] }, "consentedAt": { "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))$" } } }, "aboutMe": { "type": "object", "properties": { "interests": { "type": "array", "items": { "type": "string" }, "description": "free-text interest tags for the membership", "examples": [ [ "hiking", "jazz", "baking" ] ] }, "preferredCommunication": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "how this person prefers to be communicated with", "examples": [ "Slack, async where possible" ] }, "thingsToKnow": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "anything else colleagues should know", "examples": [ "Deaf in one ear — face me when speaking, please." ] } }, "required": [ "interests", "preferredCommunication", "thingsToKnow" ], "nullable": true } }, "required": [ "id", "individualId", "firstName", "lastName", "email", "status", "role", "department", "location", "jobTitle", "photoHash", "managerId", "managerName", "directReportCount", "invitationStatus", "connectionPowerType", "createdAt", "hrisId", "personalEmail", "memberships", "managerLinks", "pendingChange", "photoUrl", "updatedAt", "auditSummary", "connectionScore", "behaviourProfile", "personalisedInsights", "demographics", "aboutMe" ] }, "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": 1000 }, "i": { "type": "integer", "minimum": 0, "maximum": 1000 }, "s": { "type": "integer", "minimum": 0, "maximum": 1000 }, "c": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "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))$" }, "discAdvanced": { "type": "object", "properties": { "workMaskScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 1000 }, "i": { "type": "integer", "minimum": 0, "maximum": 1000 }, "s": { "type": "integer", "minimum": 0, "maximum": 1000 }, "c": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "required": [ "d", "i", "s", "c" ] }, "underPressureScores": { "type": "object", "properties": { "d": { "type": "integer", "minimum": 0, "maximum": 1000 }, "i": { "type": "integer", "minimum": 0, "maximum": 1000 }, "s": { "type": "integer", "minimum": 0, "maximum": 1000 }, "c": { "type": "integer", "minimum": 0, "maximum": 1000 } }, "required": [ "d", "i", "s", "c" ] } }, "required": [ "workMaskScores", "underPressureScores" ], "additionalProperties": false } }, "required": [ "connectionPowerType", "traitSpectrums", "selfImageScores", "scoredAt" ], "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" ] }, "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": [ [] ] }, "teamProfileSummary": { "anyOf": [ { "type": "array", "items": { "type": "object", "properties": { "trait": { "type": "string", "enum": [ "D", "I", "S", "C" ], "description": "the DISC trait this Detail-tab profile paragraph belongs to", "examples": [ "S" ] }, "content": { "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": "the trait × mean-team-band profile paragraph — null when that item is unauthored", "examples": [ null ] } }, "required": [ "trait", "content" ] } }, { "type": "null" } ], "description": "per-DISC-trait Detail-tab profile paragraphs (D/I/S/C order) — null when no assessed members", "examples": [ null ] } }, "required": [ "teamId", "members", "powerDistribution", "dominantPower", "strengthsAndWatchouts", "teamProfileSummary" ] } } }, "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" ] } ] }