Socotra

Socotra Work Management API

The Work Management API from Socotra — 39 operation(s) for work management.

GitHub OpenAPI

Operations 43

POST /work-management/{tenantLocator}/workplans #
POST /work-management/{tenantLocator}/workgroups #
POST /work-management/{tenantLocator}/userAssociations #
POST /work-management/{tenantLocator}/tasks #
POST /work-management/{tenantLocator}/tasks/{locator}/number/set #
POST /work-management/{tenantLocator}/tasks/{locator}/number/generate #
POST /work-management/{tenantLocator}/assignments #
GET /work-management/{tenantLocator}/workplans/{locator} #
PATCH /work-management/{tenantLocator}/workplans/{locator} #
PATCH /work-management/{tenantLocator}/workplans/{locator}/discard #
GET /work-management/{tenantLocator}/workgroups/{workgroupLocator} #
PATCH /work-management/{tenantLocator}/workgroups/{workgroupLocator} #
PATCH /work-management/{tenantLocator}/workgroups/{workgroupLocator}/discard #
PATCH /work-management/{tenantLocator}/userAssociations/{userAssociationLocator}/uncomplete #
PATCH /work-management/{tenantLocator}/userAssociations/{userAssociationLocator}/disassociate #
PATCH /work-management/{tenantLocator}/userAssociations/{userAssociationLocator}/complete #
GET /work-management/{tenantLocator}/tasks/{locator} #
PATCH /work-management/{tenantLocator}/tasks/{locator} #
PATCH /work-management/{tenantLocator}/tasks/{locator}/unassign #
PATCH /work-management/{tenantLocator}/tasks/{locator}/complete #
PATCH /work-management/{tenantLocator}/tasks/{locator}/cancel #
PATCH /work-management/{tenantLocator}/tasks/{locator}/assign/{userLocator} #
PATCH /work-management/{tenantLocator}/tasks/{locator}/activate #
GET /work-management/{tenantLocator}/qualifications/{userLocator} #
PATCH /work-management/{tenantLocator}/qualifications/{userLocator} #
GET /work-management/{tenantLocator}/workplans/list #
GET /work-management/{tenantLocator}/workgroups/list #
GET /work-management/{tenantLocator}/userAssociations/{referenceType}/{referenceLocator}/{userAssociationState}/list #
GET /work-management/{tenantLocator}/userAssociations/{referenceType}/{referenceLocator}/history/list #
GET /work-management/{tenantLocator}/userAssociations/{locator} #
GET /work-management/{tenantLocator}/userAssociations/{locator}/history/list #
GET /work-management/{tenantLocator}/userAssociations/user/{userLocator}/{userAssociationState}/list #
GET /work-management/{tenantLocator}/userAssociations/user/{userLocator}/qualifiedRoles/list #
GET /work-management/{tenantLocator}/userAssociations/user/{userLocator}/history/list #
GET /work-management/{tenantLocator}/tasks/{referenceType}/{referenceLocator}/list #
GET /work-management/{tenantLocator}/tasks/{locator}/history/list #
GET /work-management/{tenantLocator}/tasks/user/{userLocator}/list #
GET /work-management/{tenantLocator}/tasks/numbers/{taskNumber} #
GET /work-management/{tenantLocator}/tasks/list #
GET /work-management/{tenantLocator}/tasks/all/list #
GET /work-management/{tenantLocator}/qualifications #
GET /work-management/{tenantLocator}/qualifications/{category}/{level} #
GET /work-management/events #

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/socotra/refs/heads/main/openapi/socotra-work-management-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/socotra-work-management-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

socotra-work-management-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Socotra Insurance Suite OpenAPI Definition Work Management API
  description: Socotra Insurance Suite API
  termsOfService: https://www.socotra.com
  version: v0
servers:
- url: /
  description: Generated server url
tags:
- name: Work Management
paths:
  /work-management/{tenantLocator}/workplans:
    post:
      operationId: createWorkplan
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkplanCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Workplan'
                deprecated: false
      x-securityGroup: workplans
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workgroups:
    post:
      operationId: createWorkgroup
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkgroupCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WorkgroupResponse'
                deprecated: false
      x-securityGroup: workgroups
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations:
    post:
      operationId: makeUserAssociation
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserAssociationCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/UserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks:
    post:
      operationId: addTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/number/set:
    post:
      operationId: setTaskNumber
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: taskNumber
        in: query
        required: true
        schema:
          type: string
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/number/generate:
    post:
      operationId: generateTaskNumber
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/assignments:
    post:
      operationId: autoAssign
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AutoAssignmentCreateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/AutoAssignmentResponse'
                deprecated: false
      x-securityGroup: assignments
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workplans/{locator}:
    get:
      operationId: getWorkplan
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Workplan'
                deprecated: false
      x-securityGroup: workplans
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
    patch:
      operationId: patchWorkplan
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkplanPatchRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Workplan'
                deprecated: false
      x-securityGroup: workplans
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workplans/{locator}/discard:
    patch:
      operationId: discardWorkplan
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Workplan'
                deprecated: false
      x-securityGroup: workplans
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workgroups/{workgroupLocator}:
    get:
      operationId: getWorkgroup
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: workgroupLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WorkgroupResponse'
                deprecated: false
      x-securityGroup: workgroups
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
    patch:
      operationId: patchWorkgroup
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: workgroupLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/WorkgroupPatchRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WorkgroupResponse'
                deprecated: false
      x-securityGroup: workgroups
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workgroups/{workgroupLocator}/discard:
    patch:
      operationId: discardWorkgroup
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: workgroupLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WorkgroupResponse'
                deprecated: false
      x-securityGroup: workgroups
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{userAssociationLocator}/uncomplete:
    patch:
      operationId: uncompleteUserAssociation
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userAssociationLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/UserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{userAssociationLocator}/disassociate:
    patch:
      operationId: disassociateUserAssociation
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userAssociationLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/UserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{userAssociationLocator}/complete:
    patch:
      operationId: completeUserAssociation
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userAssociationLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/UserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}:
    get:
      operationId: getTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
    patch:
      operationId: updateTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TaskUpdateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/unassign:
    patch:
      operationId: unassignTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/complete:
    patch:
      operationId: completeTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/cancel:
    patch:
      operationId: cancelTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/assign/{userLocator}:
    patch:
      operationId: assignTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: userLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{locator}/activate:
    patch:
      operationId: activateTask
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Task'
                deprecated: false
      x-securityGroup: tasks
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/qualifications/{userLocator}:
    get:
      operationId: getUserQualifications
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                deprecated: false
                additionalProperties:
                  type: string
                  deprecated: false
      x-securityGroup: qualifications
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
    patch:
      operationId: updateUserQualifications
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QualificationsUpdateRequest'
              deprecated: false
        required: true
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                type: object
                deprecated: false
                additionalProperties:
                  type: string
                  deprecated: false
      x-securityGroup: qualifications
      x-securityPermission:
      - write
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workplans/list:
    get:
      operationId: listWorkplans
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseWorkplan'
                deprecated: false
      x-securityGroup: workplans
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/workgroups/list:
    get:
      operationId: listWorkgroups
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: user
        in: query
        required: false
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseWorkgroupResponse'
                deprecated: false
      x-securityGroup: workgroups
      x-securityPermission:
      - read
      - list
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{referenceType}/{referenceLocator}/{userAssociationState}/list:
    get:
      operationId: listAssignedUsers
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: referenceType
        in: path
        required: true
        schema:
          type: string
          enum:
          - account
          - quickQuote
          - quote
          - policy
          - transaction
          - invoice
          - underwritingFlag
          - payment
          - quoteGroup
          - inquiry
          deprecated: false
      - name: referenceLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: userAssociationState
        in: path
        required: true
        schema:
          type: string
          enum:
          - active
          - completed
          - disassociated
          - discarded
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseUserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{referenceType}/{referenceLocator}/history/list:
    get:
      operationId: listReferenceUserAssociationsHistory
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: referenceType
        in: path
        required: true
        schema:
          type: string
          enum:
          - account
          - quickQuote
          - quote
          - policy
          - transaction
          - invoice
          - underwritingFlag
          - payment
          - quoteGroup
          - inquiry
          deprecated: false
      - name: referenceLocator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseUserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{locator}:
    get:
      operationId: getUserAssociation
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/UserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/{locator}/history/list:
    get:
      operationId: listUserAssociationHistory
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: locator
        in: path
        required: true
        schema:
          type: string
          format: ulid
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseUserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/user/{userLocator}/{userAssociationState}/list:
    get:
      operationId: listUserUserAssociations
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userAssociationState
        in: path
        required: true
        schema:
          type: string
          enum:
          - active
          - completed
          - disassociated
          - discarded
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseUserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/user/{userLocator}/qualifiedRoles/list:
    get:
      operationId: listUserQualifiedRoles
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: referenceType
        in: query
        required: false
        schema:
          type: string
          enum:
          - account
          - quickQuote
          - quote
          - policy
          - transaction
          - invoice
          - underwritingFlag
          - payment
          - quoteGroup
          - inquiry
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/UserQualifiedRolesResponse'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/userAssociations/user/{userLocator}/history/list:
    get:
      operationId: listUserUserAssociationsHistory
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: userLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      - name: count
        in: query
        required: false
        schema:
          type: integer
          format: int32
          deprecated: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ListPageResponseUserAssociation'
                deprecated: false
      x-securityGroup: user-associations
      x-securityPermission:
      - read
      deprecated: false
      tags:
      - Work Management
  /work-management/{tenantLocator}/tasks/{referenceType}/{referenceLocator}/list:
    get:
      operationId: searchTasks
      parameters:
      - name: tenantLocator
        in: path
        required: true
        schema:
          type: string
          format: uuid
          deprecated: false
      - name: referenceType
        in: path
        required: true
        schema:
          type: string
          enum:
          - account
          - quickQuote
          - quote
          - policy
          - transaction
          - invoice
   

# --- truncated at 32 KB (60 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/socotra/refs/heads/main/openapi/socotra-work-management-api-openapi.yml