> For the complete documentation index, see [llms.txt](https://tsanet.gitbook.io/connect/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tsanet.gitbook.io/connect/api-reference/collaboration-requests.md).

# Collaboration Requests

Case creation, retrieval, and management

## Get collaboration requests

> \*\*Deprecated\*\* — use \`GET /v2/collaboration-requests\` instead.\
> This endpoint will be removed after 2027-01-01.<br>

```json
{"openapi":"3.0.3","info":{"title":"TSANet Connect Core API","version":"1.0.0"},"tags":[{"name":"Collaboration Requests","description":"Case creation, retrieval, and management"}],"servers":[{"url":"http://localhost:8080","description":"Local"},{"url":"https://connect2.tahoelab.us","description":"Dev"},{"url":"https://connect2.tsanet.net","description":"Beta"},{"url":"https://connect2.tsanet.org","description":"Prod"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Paste a Bearer JWT here. Two token types are accepted:\n\n**Connect1 User Tokens** — issued by the Connect1 identity service. Copy the token from your Connect1 session.\n\n**Azure AD M2M** — use the `azureClientCredentials` scheme below to get a token, then paste it here.\n"}},"schemas":{"CollaborationRequestListResponse":{"type":"array","items":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}},"CollaborationRequestStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"submitCompanyName":{"type":"string","maxLength":191},"submitCompanyId":{"type":"integer","format":"int64"},"submitterCaseNumber":{"type":"string","maxLength":191},"receiveCompanyName":{"type":"string","maxLength":191},"receiveCompanyId":{"type":"integer","format":"int64"},"receiverCaseNumber":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":10000},"direction":{"$ref":"#/components/schemas/CollaborationRequestDirection"},"priority":{"$ref":"#/components/schemas/CasePriority"},"status":{"$ref":"#/components/schemas/CaseStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time","nullable":true},"responded":{"type":"boolean"},"respondBy":{"type":"string","format":"date-time"},"feedbackRequested":{"type":"boolean"},"reminderSent":{"type":"boolean"},"priorityNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"contactDocumentId":{"type":"integer","format":"int64","description":"ID of the contact document used to create this case"},"contactDocumentName":{"type":"string","maxLength":191,"description":"Name of the contact document used to create this case"},"testCase":{"type":"boolean"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/CaseCustomFieldStatusDTO"}},"submittedBy":{"$ref":"#/components/schemas/UserDTO"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"receiverContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"caseNotes":{"type":"array","items":{"$ref":"#/components/schemas/CaseNoteDTO"}},"caseResponses":{"type":"array","items":{"$ref":"#/components/schemas/CaseResponseDTO"}}}},"CollaborationRequestDirection":{"type":"string","enum":["OUTBOUND","INBOUND"]},"CasePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"CaseStatus":{"type":"string","enum":["OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED"]},"CaseCustomFieldStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"fieldName":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"displayOrder":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/FieldMetadataType"}}},"FieldMetadataSection":{"type":"string","enum":["CONTACT_SECTION","COMMON_CUSTOMER_SECTION","PROBLEM_SECTION"]},"FieldMetadataType":{"type":"string","enum":["STRING","INTEGER","EMAIL","PHONE","URL","TEXT","HIDDEN","CUSTOM","SELECT","TIERSELECT","GROUPSELECT","COPY","DB_SELECT","TIMEZONE"]},"UserDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"username":{"type":"string","maxLength":191},"firstName":{"type":"string","maxLength":191},"lastName":{"type":"string","maxLength":191},"email":{"type":"string","maxLength":191},"phone":{"type":"string","maxLength":50},"phoneCountryCode":{"type":"string","maxLength":10},"city":{"type":"string","maxLength":191},"emailCheckFailData":{"type":"string","maxLength":191}}},"ContactDetailsDTO":{"type":"object","required":["name","email","phone"],"properties":{"name":{"type":"string","maxLength":191,"description":"Full name of the contact"},"email":{"type":"string","format":"email","maxLength":191,"description":"Email address of the contact"},"phone":{"type":"string","maxLength":50,"description":"Phone number of the contact"}}},"CaseNoteDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"caseId":{"type":"integer","format":"int64"},"companyName":{"type":"string","maxLength":191},"creatorUsername":{"type":"string","maxLength":191},"creatorEmail":{"type":"string","maxLength":191},"creatorName":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":5000},"priority":{"$ref":"#/components/schemas/NotePriority"},"status":{"$ref":"#/components/schemas/NoteStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NotePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"NoteStatus":{"type":"string","enum":["ENTERED","READ","RESPONDED","REMOVED"]},"CaseResponseDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/CaseResponseType"},"caseNumber":{"type":"string","maxLength":191},"engineerName":{"type":"string","maxLength":191},"engineerPhone":{"type":"string","maxLength":50},"engineerEmail":{"type":"string","format":"email","maxLength":191},"nextSteps":{"type":"string","maxLength":5000},"createdAt":{"type":"string","format":"date-time"}}},"CaseResponseType":{"type":"string","enum":["APPROVAL","INFORMATION_REQUEST","INFORMATION_RESPONSE","REJECTION"]},"PagedResponse":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}},"number":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"}}},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"validationErrors":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"}},"additionalProperties":true}}},"paths":{"/v1/collaboration-requests":{"get":{"tags":["Collaboration Requests"],"summary":"Get collaboration requests","deprecated":true,"description":"**Deprecated** — use `GET /v2/collaboration-requests` instead.\nThis endpoint will be removed after 2027-01-01.\n","operationId":"getCollaborationRequests","parameters":[{"name":"internalCaseNumber","in":"query","required":false,"description":"Your internal case number","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Filter by collaboration requests type (optional) - all by default","schema":{"type":"string","default":"ALL"}},{"name":"status","in":"query","required":false,"description":"Filter by collaboration requests status (optional) - all by default","schema":{"type":"string","default":"ALL"}},{"name":"updatedAfter","in":"query","required":false,"description":"Filter by collaboration requests that were updated after (YYYY-MM-DDTHH:MM:SSZ)","schema":{"type":"string","format":"date-time"}},{"name":"createdAfter","in":"query","required":false,"description":"Filter by collaboration requests that were created after (YYYY-MM-DDTHH:MM:SSZ)","schema":{"type":"string","format":"date-time"}},{"name":"includeRemovedNotes","in":"query","required":false,"description":"Filter to include removed notes - excluded by default","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","required":false,"description":"Page number (0-based) for pagination when paginated is true","schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"description":"Page size for pagination when paginated is true (0 means return all records)","schema":{"type":"integer","format":"int32","default":0,"minimum":0,"maximum":500}},{"name":"paginated","in":"query","required":false,"description":"Set to 'true' to request paginated results instead of an array. If true, the updatedAfter and createdAfter filters are ignored.","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"List of collaboration requests or paginated response","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/CollaborationRequestListResponse"},{"$ref":"#/components/schemas/PagedResponse"}]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## POST /v1/collaboration-requests

> Create a new collaboration request

```json
{"openapi":"3.0.3","info":{"title":"TSANet Connect Core API","version":"1.0.0"},"tags":[{"name":"Collaboration Requests","description":"Case creation, retrieval, and management"}],"servers":[{"url":"http://localhost:8080","description":"Local"},{"url":"https://connect2.tahoelab.us","description":"Dev"},{"url":"https://connect2.tsanet.net","description":"Beta"},{"url":"https://connect2.tsanet.org","description":"Prod"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Paste a Bearer JWT here. Two token types are accepted:\n\n**Connect1 User Tokens** — issued by the Connect1 identity service. Copy the token from your Connect1 session.\n\n**Azure AD M2M** — use the `azureClientCredentials` scheme below to get a token, then paste it here.\n"}},"schemas":{"CollaborationRequestDTO":{"type":"object","required":["customFields","internalCaseNumber","problemSummary","problemDescription","documentId","priority","internalNotes","testSubmission"],"properties":{"documentId":{"type":"integer","format":"int64"},"internalCaseNumber":{"type":"string","maxLength":191},"receiverInternalCaseNumber":{"type":"string","maxLength":191},"problemSummary":{"type":"string","maxLength":500},"problemDescription":{"type":"string","maxLength":10000},"priority":{"$ref":"#/components/schemas/CasePriority"},"adminNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO","description":"Contact details of the engineer submitting the collaboration request"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/FieldMetadataDTO"}},"internalNotes":{"type":"array","items":{"$ref":"#/components/schemas/InternalNoteDTO"}},"testSubmission":{"type":"boolean"}}},"CasePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"ContactDetailsDTO":{"type":"object","required":["name","email","phone"],"properties":{"name":{"type":"string","maxLength":191,"description":"Full name of the contact"},"email":{"type":"string","format":"email","maxLength":191,"description":"Email address of the contact"},"phone":{"type":"string","maxLength":50,"description":"Phone number of the contact"}}},"FieldMetadataDTO":{"type":"object","required":["fieldId","section","label","type","displayOrder","required"],"properties":{"fieldId":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"label":{"type":"string","maxLength":191},"options":{"type":"string","maxLength":5000},"additionalSettings":{"type":"string","maxLength":5000},"type":{"$ref":"#/components/schemas/FieldMetadataType"},"displayOrder":{"type":"integer","format":"int32"},"validationRules":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"selections":{"type":"array","items":{"$ref":"#/components/schemas/SelectionDTO"}},"required":{"type":"boolean"}}},"FieldMetadataSection":{"type":"string","enum":["CONTACT_SECTION","COMMON_CUSTOMER_SECTION","PROBLEM_SECTION"]},"FieldMetadataType":{"type":"string","enum":["STRING","INTEGER","EMAIL","PHONE","URL","TEXT","HIDDEN","CUSTOM","SELECT","TIERSELECT","GROUPSELECT","COPY","DB_SELECT","TIMEZONE"]},"SelectionDTO":{"type":"object","properties":{"value":{"type":"string","maxLength":191},"children":{"uniqueItems":true,"type":"array","items":{"$ref":"#/components/schemas/SelectionDTO"}}}},"InternalNoteDTO":{"type":"object","properties":{"note":{"type":"string","maxLength":5000}}},"CollaborationRequestStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"submitCompanyName":{"type":"string","maxLength":191},"submitCompanyId":{"type":"integer","format":"int64"},"submitterCaseNumber":{"type":"string","maxLength":191},"receiveCompanyName":{"type":"string","maxLength":191},"receiveCompanyId":{"type":"integer","format":"int64"},"receiverCaseNumber":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":10000},"direction":{"$ref":"#/components/schemas/CollaborationRequestDirection"},"priority":{"$ref":"#/components/schemas/CasePriority"},"status":{"$ref":"#/components/schemas/CaseStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time","nullable":true},"responded":{"type":"boolean"},"respondBy":{"type":"string","format":"date-time"},"feedbackRequested":{"type":"boolean"},"reminderSent":{"type":"boolean"},"priorityNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"contactDocumentId":{"type":"integer","format":"int64","description":"ID of the contact document used to create this case"},"contactDocumentName":{"type":"string","maxLength":191,"description":"Name of the contact document used to create this case"},"testCase":{"type":"boolean"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/CaseCustomFieldStatusDTO"}},"submittedBy":{"$ref":"#/components/schemas/UserDTO"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"receiverContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"caseNotes":{"type":"array","items":{"$ref":"#/components/schemas/CaseNoteDTO"}},"caseResponses":{"type":"array","items":{"$ref":"#/components/schemas/CaseResponseDTO"}}}},"CollaborationRequestDirection":{"type":"string","enum":["OUTBOUND","INBOUND"]},"CaseStatus":{"type":"string","enum":["OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED"]},"CaseCustomFieldStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"fieldName":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"displayOrder":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/FieldMetadataType"}}},"UserDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"username":{"type":"string","maxLength":191},"firstName":{"type":"string","maxLength":191},"lastName":{"type":"string","maxLength":191},"email":{"type":"string","maxLength":191},"phone":{"type":"string","maxLength":50},"phoneCountryCode":{"type":"string","maxLength":10},"city":{"type":"string","maxLength":191},"emailCheckFailData":{"type":"string","maxLength":191}}},"CaseNoteDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"caseId":{"type":"integer","format":"int64"},"companyName":{"type":"string","maxLength":191},"creatorUsername":{"type":"string","maxLength":191},"creatorEmail":{"type":"string","maxLength":191},"creatorName":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":5000},"priority":{"$ref":"#/components/schemas/NotePriority"},"status":{"$ref":"#/components/schemas/NoteStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NotePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"NoteStatus":{"type":"string","enum":["ENTERED","READ","RESPONDED","REMOVED"]},"CaseResponseDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/CaseResponseType"},"caseNumber":{"type":"string","maxLength":191},"engineerName":{"type":"string","maxLength":191},"engineerPhone":{"type":"string","maxLength":50},"engineerEmail":{"type":"string","format":"email","maxLength":191},"nextSteps":{"type":"string","maxLength":5000},"createdAt":{"type":"string","format":"date-time"}}},"CaseResponseType":{"type":"string","enum":["APPROVAL","INFORMATION_REQUEST","INFORMATION_RESPONSE","REJECTION"]},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"validationErrors":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"}},"additionalProperties":true}}},"paths":{"/v1/collaboration-requests":{"post":{"tags":["Collaboration Requests"],"summary":"Create a new collaboration request","operationId":"createCollaborationRequest","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestDTO"}}}},"responses":{"200":{"description":"Collaboration request created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## GET /v2/collaboration-requests

> Get collaboration requests (paginated)

```json
{"openapi":"3.0.3","info":{"title":"TSANet Connect Core API","version":"1.0.0"},"tags":[{"name":"Collaboration Requests","description":"Case creation, retrieval, and management"}],"servers":[{"url":"http://localhost:8080","description":"Local"},{"url":"https://connect2.tahoelab.us","description":"Dev"},{"url":"https://connect2.tsanet.net","description":"Beta"},{"url":"https://connect2.tsanet.org","description":"Prod"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Paste a Bearer JWT here. Two token types are accepted:\n\n**Connect1 User Tokens** — issued by the Connect1 identity service. Copy the token from your Connect1 session.\n\n**Azure AD M2M** — use the `azureClientCredentials` scheme below to get a token, then paste it here.\n"}},"schemas":{"CollaborationRequestType":{"type":"string","enum":["ALL","INBOUND","OUTBOUND"],"default":"ALL"},"CollaborationRequestStatus":{"type":"string","enum":["ALL","OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED","PENDINGACTION"],"default":"ALL"},"PagedResponse":{"type":"object","properties":{"content":{"type":"array","items":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}},"number":{"type":"integer","format":"int32"},"size":{"type":"integer","format":"int32"},"totalElements":{"type":"integer","format":"int64"},"totalPages":{"type":"integer","format":"int32"},"first":{"type":"boolean"},"last":{"type":"boolean"}}},"CollaborationRequestStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"submitCompanyName":{"type":"string","maxLength":191},"submitCompanyId":{"type":"integer","format":"int64"},"submitterCaseNumber":{"type":"string","maxLength":191},"receiveCompanyName":{"type":"string","maxLength":191},"receiveCompanyId":{"type":"integer","format":"int64"},"receiverCaseNumber":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":10000},"direction":{"$ref":"#/components/schemas/CollaborationRequestDirection"},"priority":{"$ref":"#/components/schemas/CasePriority"},"status":{"$ref":"#/components/schemas/CaseStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time","nullable":true},"responded":{"type":"boolean"},"respondBy":{"type":"string","format":"date-time"},"feedbackRequested":{"type":"boolean"},"reminderSent":{"type":"boolean"},"priorityNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"contactDocumentId":{"type":"integer","format":"int64","description":"ID of the contact document used to create this case"},"contactDocumentName":{"type":"string","maxLength":191,"description":"Name of the contact document used to create this case"},"testCase":{"type":"boolean"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/CaseCustomFieldStatusDTO"}},"submittedBy":{"$ref":"#/components/schemas/UserDTO"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"receiverContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"caseNotes":{"type":"array","items":{"$ref":"#/components/schemas/CaseNoteDTO"}},"caseResponses":{"type":"array","items":{"$ref":"#/components/schemas/CaseResponseDTO"}}}},"CollaborationRequestDirection":{"type":"string","enum":["OUTBOUND","INBOUND"]},"CasePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"CaseStatus":{"type":"string","enum":["OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED"]},"CaseCustomFieldStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"fieldName":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"displayOrder":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/FieldMetadataType"}}},"FieldMetadataSection":{"type":"string","enum":["CONTACT_SECTION","COMMON_CUSTOMER_SECTION","PROBLEM_SECTION"]},"FieldMetadataType":{"type":"string","enum":["STRING","INTEGER","EMAIL","PHONE","URL","TEXT","HIDDEN","CUSTOM","SELECT","TIERSELECT","GROUPSELECT","COPY","DB_SELECT","TIMEZONE"]},"UserDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"username":{"type":"string","maxLength":191},"firstName":{"type":"string","maxLength":191},"lastName":{"type":"string","maxLength":191},"email":{"type":"string","maxLength":191},"phone":{"type":"string","maxLength":50},"phoneCountryCode":{"type":"string","maxLength":10},"city":{"type":"string","maxLength":191},"emailCheckFailData":{"type":"string","maxLength":191}}},"ContactDetailsDTO":{"type":"object","required":["name","email","phone"],"properties":{"name":{"type":"string","maxLength":191,"description":"Full name of the contact"},"email":{"type":"string","format":"email","maxLength":191,"description":"Email address of the contact"},"phone":{"type":"string","maxLength":50,"description":"Phone number of the contact"}}},"CaseNoteDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"caseId":{"type":"integer","format":"int64"},"companyName":{"type":"string","maxLength":191},"creatorUsername":{"type":"string","maxLength":191},"creatorEmail":{"type":"string","maxLength":191},"creatorName":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":5000},"priority":{"$ref":"#/components/schemas/NotePriority"},"status":{"$ref":"#/components/schemas/NoteStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NotePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"NoteStatus":{"type":"string","enum":["ENTERED","READ","RESPONDED","REMOVED"]},"CaseResponseDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/CaseResponseType"},"caseNumber":{"type":"string","maxLength":191},"engineerName":{"type":"string","maxLength":191},"engineerPhone":{"type":"string","maxLength":50},"engineerEmail":{"type":"string","format":"email","maxLength":191},"nextSteps":{"type":"string","maxLength":5000},"createdAt":{"type":"string","format":"date-time"}}},"CaseResponseType":{"type":"string","enum":["APPROVAL","INFORMATION_REQUEST","INFORMATION_RESPONSE","REJECTION"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"}},"additionalProperties":true}}},"paths":{"/v2/collaboration-requests":{"get":{"tags":["Collaboration Requests"],"summary":"Get collaboration requests (paginated)","operationId":"getCollaborationRequestsPaginated","parameters":[{"name":"internalCaseNumber","in":"query","required":false,"description":"Your internal case number","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Filter by collaboration request type (optional) - all by default","schema":{"$ref":"#/components/schemas/CollaborationRequestType"}},{"name":"status","in":"query","required":false,"description":"Filter by collaboration request status (optional) - all by default","schema":{"$ref":"#/components/schemas/CollaborationRequestStatus"}},{"name":"includeRemovedNotes","in":"query","required":false,"description":"Include removed notes - excluded by default","schema":{"type":"boolean","default":false}},{"name":"page","in":"query","required":false,"description":"Page number (0-based)","schema":{"type":"integer","format":"int32","default":0,"minimum":0}},{"name":"size","in":"query","required":false,"description":"Page size (0 means return all records)","schema":{"type":"integer","format":"int32","default":25,"minimum":0,"maximum":500}}],"responses":{"200":{"description":"Paginated list of collaboration requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PagedResponse"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"Access denied","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## GET /v2/collaboration-requests/list

> List collaboration requests

```json
{"openapi":"3.0.3","info":{"title":"TSANet Connect Core API","version":"1.0.0"},"tags":[{"name":"Collaboration Requests","description":"Case creation, retrieval, and management"}],"servers":[{"url":"http://localhost:8080","description":"Local"},{"url":"https://connect2.tahoelab.us","description":"Dev"},{"url":"https://connect2.tsanet.net","description":"Beta"},{"url":"https://connect2.tsanet.org","description":"Prod"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Paste a Bearer JWT here. Two token types are accepted:\n\n**Connect1 User Tokens** — issued by the Connect1 identity service. Copy the token from your Connect1 session.\n\n**Azure AD M2M** — use the `azureClientCredentials` scheme below to get a token, then paste it here.\n"}},"schemas":{"CollaborationRequestType":{"type":"string","enum":["ALL","INBOUND","OUTBOUND"],"default":"ALL"},"CollaborationRequestStatus":{"type":"string","enum":["ALL","OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED","PENDINGACTION"],"default":"ALL"},"CollaborationRequestListResponse":{"type":"array","items":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}},"CollaborationRequestStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"submitCompanyName":{"type":"string","maxLength":191},"submitCompanyId":{"type":"integer","format":"int64"},"submitterCaseNumber":{"type":"string","maxLength":191},"receiveCompanyName":{"type":"string","maxLength":191},"receiveCompanyId":{"type":"integer","format":"int64"},"receiverCaseNumber":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":10000},"direction":{"$ref":"#/components/schemas/CollaborationRequestDirection"},"priority":{"$ref":"#/components/schemas/CasePriority"},"status":{"$ref":"#/components/schemas/CaseStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time","nullable":true},"responded":{"type":"boolean"},"respondBy":{"type":"string","format":"date-time"},"feedbackRequested":{"type":"boolean"},"reminderSent":{"type":"boolean"},"priorityNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"contactDocumentId":{"type":"integer","format":"int64","description":"ID of the contact document used to create this case"},"contactDocumentName":{"type":"string","maxLength":191,"description":"Name of the contact document used to create this case"},"testCase":{"type":"boolean"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/CaseCustomFieldStatusDTO"}},"submittedBy":{"$ref":"#/components/schemas/UserDTO"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"receiverContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"caseNotes":{"type":"array","items":{"$ref":"#/components/schemas/CaseNoteDTO"}},"caseResponses":{"type":"array","items":{"$ref":"#/components/schemas/CaseResponseDTO"}}}},"CollaborationRequestDirection":{"type":"string","enum":["OUTBOUND","INBOUND"]},"CasePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"CaseStatus":{"type":"string","enum":["OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED"]},"CaseCustomFieldStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"fieldName":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"displayOrder":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/FieldMetadataType"}}},"FieldMetadataSection":{"type":"string","enum":["CONTACT_SECTION","COMMON_CUSTOMER_SECTION","PROBLEM_SECTION"]},"FieldMetadataType":{"type":"string","enum":["STRING","INTEGER","EMAIL","PHONE","URL","TEXT","HIDDEN","CUSTOM","SELECT","TIERSELECT","GROUPSELECT","COPY","DB_SELECT","TIMEZONE"]},"UserDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"username":{"type":"string","maxLength":191},"firstName":{"type":"string","maxLength":191},"lastName":{"type":"string","maxLength":191},"email":{"type":"string","maxLength":191},"phone":{"type":"string","maxLength":50},"phoneCountryCode":{"type":"string","maxLength":10},"city":{"type":"string","maxLength":191},"emailCheckFailData":{"type":"string","maxLength":191}}},"ContactDetailsDTO":{"type":"object","required":["name","email","phone"],"properties":{"name":{"type":"string","maxLength":191,"description":"Full name of the contact"},"email":{"type":"string","format":"email","maxLength":191,"description":"Email address of the contact"},"phone":{"type":"string","maxLength":50,"description":"Phone number of the contact"}}},"CaseNoteDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"caseId":{"type":"integer","format":"int64"},"companyName":{"type":"string","maxLength":191},"creatorUsername":{"type":"string","maxLength":191},"creatorEmail":{"type":"string","maxLength":191},"creatorName":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":5000},"priority":{"$ref":"#/components/schemas/NotePriority"},"status":{"$ref":"#/components/schemas/NoteStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NotePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"NoteStatus":{"type":"string","enum":["ENTERED","READ","RESPONDED","REMOVED"]},"CaseResponseDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/CaseResponseType"},"caseNumber":{"type":"string","maxLength":191},"engineerName":{"type":"string","maxLength":191},"engineerPhone":{"type":"string","maxLength":50},"engineerEmail":{"type":"string","format":"email","maxLength":191},"nextSteps":{"type":"string","maxLength":5000},"createdAt":{"type":"string","format":"date-time"}}},"CaseResponseType":{"type":"string","enum":["APPROVAL","INFORMATION_REQUEST","INFORMATION_RESPONSE","REJECTION"]},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"}},"additionalProperties":true}}},"paths":{"/v2/collaboration-requests/list":{"get":{"tags":["Collaboration Requests"],"summary":"List collaboration requests","operationId":"listCollaborationRequests","parameters":[{"name":"internalCaseNumber","in":"query","required":false,"description":"Your internal case number","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Filter by collaboration request type (optional) - all by default","schema":{"$ref":"#/components/schemas/CollaborationRequestType"}},{"name":"status","in":"query","required":false,"description":"Filter by collaboration request status (optional) - all by default","schema":{"$ref":"#/components/schemas/CollaborationRequestStatus"}},{"name":"updatedAfter","in":"query","required":false,"description":"Filter by requests updated after (YYYY-MM-DDTHH:MM:SSZ)","schema":{"type":"string","format":"date-time"}},{"name":"createdAfter","in":"query","required":false,"description":"Filter by requests created after (YYYY-MM-DDTHH:MM:SSZ)","schema":{"type":"string","format":"date-time"}},{"name":"includeRemovedNotes","in":"query","required":false,"description":"Include removed notes - excluded by default","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"List of collaboration requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestListResponse"}}}},"401":{"description":"Unauthorized","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"Access denied","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## GET /v1/collaboration-requests/{token}

> Get a specific collaboration request by token

```json
{"openapi":"3.0.3","info":{"title":"TSANet Connect Core API","version":"1.0.0"},"tags":[{"name":"Collaboration Requests","description":"Case creation, retrieval, and management"}],"servers":[{"url":"http://localhost:8080","description":"Local"},{"url":"https://connect2.tahoelab.us","description":"Dev"},{"url":"https://connect2.tsanet.net","description":"Beta"},{"url":"https://connect2.tsanet.org","description":"Prod"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Paste a Bearer JWT here. Two token types are accepted:\n\n**Connect1 User Tokens** — issued by the Connect1 identity service. Copy the token from your Connect1 session.\n\n**Azure AD M2M** — use the `azureClientCredentials` scheme below to get a token, then paste it here.\n"}},"schemas":{"CollaborationRequestStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"submitCompanyName":{"type":"string","maxLength":191},"submitCompanyId":{"type":"integer","format":"int64"},"submitterCaseNumber":{"type":"string","maxLength":191},"receiveCompanyName":{"type":"string","maxLength":191},"receiveCompanyId":{"type":"integer","format":"int64"},"receiverCaseNumber":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":10000},"direction":{"$ref":"#/components/schemas/CollaborationRequestDirection"},"priority":{"$ref":"#/components/schemas/CasePriority"},"status":{"$ref":"#/components/schemas/CaseStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time","nullable":true},"responded":{"type":"boolean"},"respondBy":{"type":"string","format":"date-time"},"feedbackRequested":{"type":"boolean"},"reminderSent":{"type":"boolean"},"priorityNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"contactDocumentId":{"type":"integer","format":"int64","description":"ID of the contact document used to create this case"},"contactDocumentName":{"type":"string","maxLength":191,"description":"Name of the contact document used to create this case"},"testCase":{"type":"boolean"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/CaseCustomFieldStatusDTO"}},"submittedBy":{"$ref":"#/components/schemas/UserDTO"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"receiverContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"caseNotes":{"type":"array","items":{"$ref":"#/components/schemas/CaseNoteDTO"}},"caseResponses":{"type":"array","items":{"$ref":"#/components/schemas/CaseResponseDTO"}}}},"CollaborationRequestDirection":{"type":"string","enum":["OUTBOUND","INBOUND"]},"CasePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"CaseStatus":{"type":"string","enum":["OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED"]},"CaseCustomFieldStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"fieldName":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"displayOrder":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/FieldMetadataType"}}},"FieldMetadataSection":{"type":"string","enum":["CONTACT_SECTION","COMMON_CUSTOMER_SECTION","PROBLEM_SECTION"]},"FieldMetadataType":{"type":"string","enum":["STRING","INTEGER","EMAIL","PHONE","URL","TEXT","HIDDEN","CUSTOM","SELECT","TIERSELECT","GROUPSELECT","COPY","DB_SELECT","TIMEZONE"]},"UserDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"username":{"type":"string","maxLength":191},"firstName":{"type":"string","maxLength":191},"lastName":{"type":"string","maxLength":191},"email":{"type":"string","maxLength":191},"phone":{"type":"string","maxLength":50},"phoneCountryCode":{"type":"string","maxLength":10},"city":{"type":"string","maxLength":191},"emailCheckFailData":{"type":"string","maxLength":191}}},"ContactDetailsDTO":{"type":"object","required":["name","email","phone"],"properties":{"name":{"type":"string","maxLength":191,"description":"Full name of the contact"},"email":{"type":"string","format":"email","maxLength":191,"description":"Email address of the contact"},"phone":{"type":"string","maxLength":50,"description":"Phone number of the contact"}}},"CaseNoteDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"caseId":{"type":"integer","format":"int64"},"companyName":{"type":"string","maxLength":191},"creatorUsername":{"type":"string","maxLength":191},"creatorEmail":{"type":"string","maxLength":191},"creatorName":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":5000},"priority":{"$ref":"#/components/schemas/NotePriority"},"status":{"$ref":"#/components/schemas/NoteStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NotePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"NoteStatus":{"type":"string","enum":["ENTERED","READ","RESPONDED","REMOVED"]},"CaseResponseDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/CaseResponseType"},"caseNumber":{"type":"string","maxLength":191},"engineerName":{"type":"string","maxLength":191},"engineerPhone":{"type":"string","maxLength":50},"engineerEmail":{"type":"string","format":"email","maxLength":191},"nextSteps":{"type":"string","maxLength":5000},"createdAt":{"type":"string","format":"date-time"}}},"CaseResponseType":{"type":"string","enum":["APPROVAL","INFORMATION_REQUEST","INFORMATION_RESPONSE","REJECTION"]},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"validationErrors":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"}},"additionalProperties":true}}},"paths":{"/v1/collaboration-requests/{token}":{"get":{"tags":["Collaboration Requests"],"summary":"Get a specific collaboration request by token","operationId":"getCollaborationRequestByToken","parameters":[{"name":"token","in":"path","required":true,"description":"The token provided by TSANet for the collaboration request","schema":{"type":"string"}},{"name":"includeRemovedNotes","in":"query","required":false,"description":"Filter to include removed notes - excluded by default","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Collaboration request details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"Access denied","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"Collaboration request not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```

## PATCH /v1/collaboration-requests/{token}

> Update collaboration request submitter details

```json
{"openapi":"3.0.3","info":{"title":"TSANet Connect Core API","version":"1.0.0"},"tags":[{"name":"Collaboration Requests","description":"Case creation, retrieval, and management"}],"servers":[{"url":"http://localhost:8080","description":"Local"},{"url":"https://connect2.tahoelab.us","description":"Dev"},{"url":"https://connect2.tsanet.net","description":"Beta"},{"url":"https://connect2.tsanet.org","description":"Prod"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Paste a Bearer JWT here. Two token types are accepted:\n\n**Connect1 User Tokens** — issued by the Connect1 identity service. Copy the token from your Connect1 session.\n\n**Azure AD M2M** — use the `azureClientCredentials` scheme below to get a token, then paste it here.\n"}},"schemas":{"CollaborationRequestSubmitterUpdateDTO":{"type":"object","properties":{"internalCaseNumber":{"type":"string","nullable":true,"maxLength":191,"description":"Internal case number for the submitter's tracking system"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO","description":"Updated contact details for the submitter engineer"}}},"ContactDetailsDTO":{"type":"object","required":["name","email","phone"],"properties":{"name":{"type":"string","maxLength":191,"description":"Full name of the contact"},"email":{"type":"string","format":"email","maxLength":191,"description":"Email address of the contact"},"phone":{"type":"string","maxLength":50,"description":"Phone number of the contact"}}},"CollaborationRequestStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"submitCompanyName":{"type":"string","maxLength":191},"submitCompanyId":{"type":"integer","format":"int64"},"submitterCaseNumber":{"type":"string","maxLength":191},"receiveCompanyName":{"type":"string","maxLength":191},"receiveCompanyId":{"type":"integer","format":"int64"},"receiverCaseNumber":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":10000},"direction":{"$ref":"#/components/schemas/CollaborationRequestDirection"},"priority":{"$ref":"#/components/schemas/CasePriority"},"status":{"$ref":"#/components/schemas/CaseStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"deletedAt":{"type":"string","format":"date-time","nullable":true},"responded":{"type":"boolean"},"respondBy":{"type":"string","format":"date-time"},"feedbackRequested":{"type":"boolean"},"reminderSent":{"type":"boolean"},"priorityNote":{"type":"string","maxLength":2000},"escalationInstructions":{"type":"string","maxLength":2000},"contactDocumentId":{"type":"integer","format":"int64","description":"ID of the contact document used to create this case"},"contactDocumentName":{"type":"string","maxLength":191,"description":"Name of the contact document used to create this case"},"testCase":{"type":"boolean"},"customFields":{"type":"array","items":{"$ref":"#/components/schemas/CaseCustomFieldStatusDTO"}},"submittedBy":{"$ref":"#/components/schemas/UserDTO"},"submitterContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"receiverContactDetails":{"$ref":"#/components/schemas/ContactDetailsDTO"},"caseNotes":{"type":"array","items":{"$ref":"#/components/schemas/CaseNoteDTO"}},"caseResponses":{"type":"array","items":{"$ref":"#/components/schemas/CaseResponseDTO"}}}},"CollaborationRequestDirection":{"type":"string","enum":["OUTBOUND","INBOUND"]},"CasePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"CaseStatus":{"type":"string","enum":["OPEN","INFORMATION","REJECTED","ACCEPTED","CLOSED"]},"CaseCustomFieldStatusDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"section":{"$ref":"#/components/schemas/FieldMetadataSection"},"fieldName":{"type":"string","maxLength":191},"value":{"type":"string","maxLength":5000},"displayOrder":{"type":"integer","format":"int32"},"type":{"$ref":"#/components/schemas/FieldMetadataType"}}},"FieldMetadataSection":{"type":"string","enum":["CONTACT_SECTION","COMMON_CUSTOMER_SECTION","PROBLEM_SECTION"]},"FieldMetadataType":{"type":"string","enum":["STRING","INTEGER","EMAIL","PHONE","URL","TEXT","HIDDEN","CUSTOM","SELECT","TIERSELECT","GROUPSELECT","COPY","DB_SELECT","TIMEZONE"]},"UserDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"username":{"type":"string","maxLength":191},"firstName":{"type":"string","maxLength":191},"lastName":{"type":"string","maxLength":191},"email":{"type":"string","maxLength":191},"phone":{"type":"string","maxLength":50},"phoneCountryCode":{"type":"string","maxLength":10},"city":{"type":"string","maxLength":191},"emailCheckFailData":{"type":"string","maxLength":191}}},"CaseNoteDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"caseId":{"type":"integer","format":"int64"},"companyName":{"type":"string","maxLength":191},"creatorUsername":{"type":"string","maxLength":191},"creatorEmail":{"type":"string","maxLength":191},"creatorName":{"type":"string","maxLength":191},"summary":{"type":"string","maxLength":500},"description":{"type":"string","maxLength":5000},"priority":{"$ref":"#/components/schemas/NotePriority"},"status":{"$ref":"#/components/schemas/NoteStatus"},"token":{"type":"string","maxLength":20},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"NotePriority":{"type":"string","enum":["LOW","MEDIUM","HIGH"]},"NoteStatus":{"type":"string","enum":["ENTERED","READ","RESPONDED","REMOVED"]},"CaseResponseDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"type":{"$ref":"#/components/schemas/CaseResponseType"},"caseNumber":{"type":"string","maxLength":191},"engineerName":{"type":"string","maxLength":191},"engineerPhone":{"type":"string","maxLength":50},"engineerEmail":{"type":"string","format":"email","maxLength":191},"nextSteps":{"type":"string","maxLength":5000},"createdAt":{"type":"string","format":"date-time"}}},"CaseResponseType":{"type":"string","enum":["APPROVAL","INFORMATION_REQUEST","INFORMATION_RESPONSE","REJECTION"]},"ErrorResponse":{"type":"object","properties":{"message":{"type":"string"},"validationErrors":{"type":"array","items":{"$ref":"#/components/schemas/ValidationError"}}}},"ValidationError":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}}},"ProblemDetail":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer","format":"int32"},"detail":{"type":"string"},"instance":{"type":"string","format":"uri"}},"additionalProperties":true}}},"paths":{"/v1/collaboration-requests/{token}":{"patch":{"tags":["Collaboration Requests"],"summary":"Update collaboration request submitter details","operationId":"updateCollaborationRequestSubmitter","parameters":[{"name":"token","in":"path","required":true,"description":"The token provided by TSANet for the collaboration request","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/merge-patch+json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestSubmitterUpdateDTO"}},"application/json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestSubmitterUpdateDTO"}}}},"responses":{"200":{"description":"Collaboration request updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CollaborationRequestStatusDTO"}}}},"400":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"403":{"description":"Access denied - only the submitter can update these details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}},"404":{"description":"Collaboration request not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}},"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}}}}}}}}
```