BeameryBeamery

Tasks Management

Task tracking and correlation analysis

All endpoints require authentication. Include your access token in the Authorization header: Authorization: Bearer your_access_token

InternalGET/v1/ja/tasks

Get all tasks

Retrieve all tasks or specific task with optimization insights

Query Parameters

  • Name
    group
    Type
    string
    Description

    Filter tasks by group name

  • Name
    type
    Type
    string
    Description

    Filter tasks by type (Technical, Business, etc.)

  • Name
    complexity
    Type
    string
    Description

    Filter tasks by complexity level (low, medium, high)

  • Name
    automationPotential
    Type
    string
    Description

    Filter tasks by automation potential (low, medium, high)

  • Name
    limit
    Type
    integer
    Description

    Number of tasks to return (default: 50, max: 100)

  • Name
    offset
    Type
    integer
    Description

    Number of tasks to skip for pagination

Response

  • Name
    success
    Type
    boolean
    Description

    Indicates if the request was successful

  • Name
    data
    Type
    array<object>
    Description

    Array of task objects, each containing:

    • id (string): Unique identifier for the task
    • name (string): Task name
    • description (string): Task description
    • automationPotential (integer): Automation potential percentage (0-100)
    • effort (string): Task effort level (low, medium, high)
    • frequency (string): Task frequency (daily, weekly, monthly, quarterly)
    • group (object): Task group with name and type properties
  • Name
    pagination
    Type
    object
    Description

    Pagination information containing:

    • total (integer): Total number of tasks
    • limit (integer): Number of items per page
    • offset (integer): Starting position
    • hasMore (boolean): Whether more results are available

Request

GET
/v1/ja/tasks
curl https://frontier.beamery.com/v1/ja/tasks \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "tasks": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-1234567890ab",
      "name": "Analyze mortgage data to identify trends",
      "description": "Examine mortgage data to uncover patterns and trends that can inform business strategies.",
      "automationPotential": 65,
      "effort": "medium",
      "frequency": "monthly",
      "group": {
        "name": "Data Analysis",
        "type": "Technical"
      }
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-2345678901bc",
      "name": "Prepare reports on mortgage performance",
      "description": "Compile and present data on mortgage performance to inform stakeholders and guide decision-making.",
      "automationPotential": 50,
      "effort": "medium",
      "frequency": "monthly",
      "group": {
        "name": "Reporting",
        "type": "Business"
      }
    }
  ],
  "pagination": {
    "total": 156,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  }
}
InternalGET/v1/ja/tasks/{taskId}

Get task

Retrieve detailed task information with related roles and skills

Path Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

Query Parameters

  • Name
    withCorrelations
    Type
    boolean
    Description

    Include skill correlations and related roles in the response (default: false)

Response

  • Name
    success
    Type
    boolean
    Description

    Indicates if the request was successful

  • Name
    data
    Type
    object
    Description

    Detailed task information containing:

    • id (string): Unique identifier for the task
    • name (string): Task name
    • description (string): Task description
    • automationPotential (integer): Automation potential percentage (0-100)
    • effort (string): Task effort level (low, medium, high)
    • frequency (string): Task frequency (daily, weekly, monthly, quarterly)
    • group (object): Task group with name and type properties
    • skillCorrelations (array, optional): Array of correlated skills with strength and reasoning (included only when withCorrelations=true)
    • relatedRoles (array, optional): Array of related job roles with correlation strength (included only when withCorrelations=true)

Request

GET
/v1/ja/tasks/{taskId}
curl "https://frontier.beamery.com/v1/ja/tasks/c3d4e5f6-a7b8-9012-cdef-345678901234?withCorrelations=true" \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "entity": {
    "id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "name": "Analyze mortgage data to identify trends",
    "description": "Examine mortgage data to uncover patterns and trends that can inform business strategies.",
    "automationPotential": 65,
    "effort": "medium",
    "frequency": "monthly",
    "group": {
      "name": "Data Analysis",
      "type": "Technical"
    },
    "skillCorrelations": [
      {
        "skillId": "2e813466-3525-46e7-817c-6400f65d6717",
        "skillName": "Network Design",
        "correlationStrength": 90,
        "correlationType": "direct",
        "reasoning": "Essential for planning and structuring network systems.",
        "isSkillGap": false
      },
      {
        "skillId": "1bdce777-8888-99aa-bbcc-123456789012",
        "skillName": "SQL",
        "correlationStrength": 80,
        "correlationType": "supportive",
        "reasoning": "Useful for querying and managing system configuration data.",
        "isSkillGap": false
      }
    ],
    "relatedRoles": [
      {
        "id": "f1e2d3c4-b5a6-7890-cdef-123456789012",
        "title": "Personal Banking Advisor",
        "correlationStrength": 60
      }
    ]
  }
}
InternalPOST/v1/ja/tasks

Create task

Create a new task with validation

Path Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

Request Body

  • Name
    name
    Type
    string
    Description

    Task name

  • Name
    description
    Type
    string
    Description

    Task description

  • Name
    complexity
    Type
    string
    Description

    Task complexity level (low, medium, high)

  • Name
    automationPotential
    Type
    string
    Description

    Automation potential (low, medium, high)

  • Name
    relatedSkills
    Type
    array<string>
    Description

    Related skill IDs

Response

  • Name
    success
    Type
    boolean
    Description

    Indicates if the task was successfully created

  • Name
    data
    Type
    object
    Description

    Created task information containing:

    • id (string): Unique identifier for the newly created task
    • name (string): Task name
    • description (string): Task description
    • effort (string): Task effort level (low, medium, high)
    • frequency (string): Task frequency (daily, weekly, monthly, quarterly)
    • automationPotential (integer): Automation potential percentage (0-100)
    • group (object): Task group with name and type properties
    • relatedSkills (array): Array of related skill IDs
    • createdAt (string): ISO timestamp when the task was created

Request

POST
/v1/ja/tasks
curl https://frontier.beamery.com/v1/ja/tasks \
  -X POST \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
        "name": "Develop risk assessment models",
        "description": "Create and maintain statistical models for evaluating credit risk and loan default probability.",
        "effort": "high",
        "frequency": "quarterly",
        "automationPotential": 40,
        "group": {
          "name": "Risk Management",
          "type": "Technical"
        },
        "relatedSkills": [
            "a8b9c0d1-e2f3-4567-bcde-890123456789",
            "b9c0d1e2-f3a4-5678-cdef-901234567890",
            "c0d1e2f3-a4b5-6789-defa-012345678901"
        ]
    }'

Response

{
  "success": true,
  "entity": {
    "id": "d1e2f3a4-b5c6-7890-efab-123456789012",
    "name": "Develop risk assessment models",
    "description": "Create and maintain statistical models for evaluating credit risk and loan default probability.",
    "effort": "high",
    "frequency": "quarterly",
    "automationPotential": 40,
    "group": {
      "name": "Risk Management",
      "type": "Technical"
    },
    "relatedSkills": ["a8b9c0d1-e2f3-4567-bcde-890123456789", "b9c0d1e2-f3a4-5678-cdef-901234567890", "c0d1e2f3-a4b5-6789-defa-012345678901"],
    "createdAt": "2024-01-15T10:30:00Z"
  }
}
InternalPATCH/v1/ja/tasks/{taskId}

Update task

Update existing task with partial data

Path Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

Request Body

  • Name
    name
    Type
    string
    Description

    Updated task name

  • Name
    description
    Type
    string
    Description

    Updated task description

  • Name
    complexity
    Type
    string
    Description

    Updated complexity level

  • Name
    automationPotential
    Type
    string
    Description

    Updated automation potential

  • Name
    relatedSkills
    Type
    array<string>
    Description

    Updated related skill IDs

Response

  • Name
    success
    Type
    boolean
    Description

    Indicates if the task was successfully updated

  • Name
    data
    Type
    object
    Description

    Updated task information containing:

    • id (string): Unique identifier for the task
    • name (string): Task name
    • description (string): Task description
    • automationPotential (integer): Automation potential percentage (0-100)
    • effort (string): Task effort level (low, medium, high)
    • frequency (string): Task frequency (daily, weekly, monthly, quarterly)
    • group (object): Task group with name and type properties
    • relatedSkills (array): Array of related skill IDs
    • updatedAt (string): ISO timestamp when the task was last updated

Request

PATCH
/v1/ja/tasks/{taskId}
curl https://frontier.beamery.com/v1/ja/tasks/d4e5f6a7-b8c9-0123-defa-456789012345 \
  -X PATCH \
  -H "Authorization: Bearer your_access_token" \
  -H "Content-Type: application/json" \
  -d '{
        "automationPotential": 75,
        "effort": "low",
        "relatedSkills": ["e5f6a7b8-c9d0-1234-efab-567890123456", "f6a7b8c9-d0e1-2345-fabc-678901234567"]
    }'

Response

{
  "success": true,
  "entity": {
    "id": "d4e5f6a7-b8c9-0123-defa-456789012345",
    "name": "Prepare reports on mortgage performance",
    "description": "Compile and present data on mortgage performance to inform stakeholders and guide decision-making.",
    "automationPotential": 75,
    "effort": "low",
    "frequency": "monthly",
    "group": {
      "name": "Reporting",
      "type": "Business"
    },
    "relatedSkills": ["e5f6a7b8-c9d0-1234-efab-567890123456", "f6a7b8c9-d0e1-2345-fabc-678901234567"],
    "updatedAt": "2024-01-15T14:45:00Z"
  }
}
InternalDELETE/v1/ja/tasks/{taskId}

Delete task

Remove a specific task permanently

Path Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

Response

  • Name
    success
    Type
    boolean
    Description

    Indicates if the deletion was successful

  • Name
    data
    Type
    object
    Description

    Response data containing:

    • message (string): Confirmation message about the task deletion

Request

DELETE
/v1/ja/tasks/{taskId}
curl https://frontier.beamery.com/v1/ja/tasks/a7b8c9d0-e1f2-3456-abcd-789012345678 \
  -X DELETE \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "message": "Task 'Collaborate with team to develop mortgage solutions' successfully deleted"
}
InternalGET/v1/ja/tasks/analytics/market

Market Analysis

Get comprehensive market analysis for tasks by analyzing their correlated skills' market data, providing insights into demand, supply, and growth trends across different job family groups and seniority levels.

This endpoint derives market insights by analyzing the skills correlated with the specified task. Market data is sourced from Lightcast but extended with Beamery intelligence to deliver enhanced insights into task market dynamics through skill correlations.

Query Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

  • Name
    jobFamilyGroup
    Type
    string
    Description

    Filter by specific job family group (e.g., "Engineering", "Sales", "Marketing")

  • Name
    seniorityLevel
    Type
    string
    Description

    Filter by seniority level (e.g., "Executive", "Director", "Mid-Senior")

  • Name
    location
    Type
    string
    Description

    Geographic location filter (e.g., "United States", "London, UK")

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of sections to include. If omitted, returns all sections:

    • supply Current talent supply metrics and availability data
    • demand Job posting volume and hiring demand indicators
    • growth Market growth trends and future projections
    • trends Historical patterns and seasonal variations
    • supplyDemandRange Supply/demand balance ratio and market tension
    • topEmployers Leading companies and organizations in the market

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    object
    Description

    Market analysis data object containing:

    • taskId (string): Unique identifier for the analyzed task
    • taskName (string): Name of the analyzed task
    • dataSource (string): Source of market data (e.g., "Lightcast (via skill correlations)")
    • lastUpdated (string): ISO timestamp of last data update
    • correlatedSkills (array): Array of correlated skills with market data
    • aggregatedInsights (object): Aggregated market insights with weighted metrics
    • topEmployers (array): Leading employers in the market segment

Request

GET
/v1/ja/tasks/analytics/market
curl "https://frontier.beamery.com/v1/ja/tasks/analytics/market?taskId=a1b2c3d4-e5f6-7890-abcd-1234567890ab&jobFamilyGroup=Engineering&seniorityLevel=Mid-Senior&sections=supply,demand,growth" \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "analytics": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-1234567890ab",
    "taskName": "API Development",
    "dataSource": "Lightcast (via skill correlations)",
    "lastUpdated": "2024-01-15T10:30:00Z",
    "correlatedSkills": [
      {
        "skillId": "b2c3d4e5-f6a7-8901-bcde-2345678901bc",
        "skillName": "JavaScript",
        "correlationStrength": 95,
        "marketData": {
          "supply": 45000,
          "demand": 32000,
          "growth": 18.5
        }
      },
      {
        "skillId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
        "skillName": "REST APIs",
        "correlationStrength": 88,
        "marketData": {
          "supply": 38000,
          "demand": 28000,
          "growth": 22.1
        }
      }
    ],
    "aggregatedInsights": {
      "weightedSupply": 125000,
      "weightedDemand": 89000,
      "projectedGrowth": 18.5,
      "supplyDemandRatio": 1.4,
      "confidenceScore": 0.85
    },
    "topEmployers": [
      {
        "id": "e1f2a3b4-c5d6-7890-efgh-234567890123",
        "name": "Microsoft",
        "demandShare": 8.2,
        "averageSalary": 145000,
        "skillsRequested": ["JavaScript", "REST APIs"]
      }
    ]
  }
}
InternalGET/v1/ja/tasks/analytics/demand

Analyze demand patterns and trends for specific tasks by examining their correlated skills' demand data across different job family groups and seniority levels.

This endpoint derives demand insights by analyzing the skills correlated with the specified task. Demand data is sourced from Lightcast but extended with Beamery intelligence to deliver enhanced insights into task demand patterns through skill correlations.

Query Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

  • Name
    jobFamilyGroup
    Type
    string
    Description

    Filter by specific job family group (e.g., "Engineering", "Sales", "Marketing")

  • Name
    seniorityLevel
    Type
    string
    Description

    Filter by seniority level (e.g., "Executive", "Director", "Mid-Senior")

  • Name
    location
    Type
    string
    Description

    Geographic location filter (e.g., "United States", "London, UK")

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of sections to include. If omitted, returns all sections:

    • trends Historical demand patterns and trajectory analysis
    • seasonality Seasonal fluctuations and cyclical patterns
    • growthAreas Emerging markets and high-growth regions
    • topRoles Most in-demand roles and position types

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    object
    Description

    Demand trends analysis data containing:

    • taskId (string): Unique identifier for the analyzed task
    • taskName (string): Name of the analyzed task
    • dataSource (string): Source of demand data (e.g., "Lightcast (via skill correlations)")
    • lastUpdated (string): ISO timestamp of last data update
    • correlatedSkills (array): Array of correlated skills with demand trends
    • aggregatedTrends (object): Aggregated demand trends with confidence scores
    • growthAreas (object): Regional and job family group growth areas

Request

GET
/v1/ja/tasks/analytics/demand
curl "https://frontier.beamery.com/v1/ja/tasks/analytics/demand?taskId=b2c3d4e5-f6a7-8901-bcde-2345678901bc&jobFamilyGroup=Engineering&sections=trends,growthAreas" \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "analytics": {
    "taskId": "b2c3d4e5-f6a7-8901-bcde-2345678901bc",
    "taskName": "Data Analysis",
    "dataSource": "Lightcast (via skill correlations)",
    "lastUpdated": "2024-01-15T10:30:00Z",
    "correlatedSkills": [
      {
        "skillId": "d3e4f5a6-b7c8-9012-defa-456789012345",
        "skillName": "Python",
        "correlationStrength": 92,
        "demandTrends": {
          "quarterly": [
            {"period": "Q1 2024", "demand": 15000, "growth": 12.5},
            {"period": "Q2 2024", "demand": 18000, "growth": 15.2}
          ]
        }
      },
      {
        "skillId": "e4f5a6b7-c8d9-0123-efab-567890123456",
        "skillName": "SQL",
        "correlationStrength": 88,
        "demandTrends": {
          "quarterly": [
            {"period": "Q1 2024", "demand": 8000, "growth": 5.8},
            {"period": "Q2 2024", "demand": 10000, "growth": 8.9}
          ]
        }
      }
    ],
    "aggregatedTrends": {
      "weightedDemand": [
        {"period": "Q1 2024", "demand": 23000, "growth": 8.5},
        {"period": "Q2 2024", "demand": 28000, "growth": 12.1}
      ],
      "confidenceScore": 0.82
    },
    "growthAreas": {
      "regions": [
        {"location": "San Francisco, CA", "growth": 25.3, "taskDemand": 12000},
        {"location": "New York, NY", "growth": 18.9, "taskDemand": 8500}
      ],
      "jobFamilyGroups": [
        {"name": "Data Science", "growth": 32.1, "taskDemand": 15000}
      ]
    }
  }
}
InternalGET/v1/ja/tasks/analytics/supply

Supply Insights

Analyze supply patterns and availability for specific tasks by examining their correlated skills' supply data across different job family groups and seniority levels.

This endpoint derives supply insights by analyzing the skills correlated with the specified task. Supply data is sourced from Lightcast but extended with Beamery intelligence to deliver enhanced insights into task supply patterns through skill correlations.

Query Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

  • Name
    jobFamilyGroup
    Type
    string
    Description

    Filter by specific job family group (e.g., "Engineering", "Sales", "Marketing")

  • Name
    seniorityLevel
    Type
    string
    Description

    Filter by seniority level (e.g., "Executive", "Director", "Mid-Senior")

  • Name
    location
    Type
    string
    Description

    Geographic location filter (e.g., "United States", "London, UK")

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of sections to include. If omitted, returns all sections:

    • availability Current talent pool size and accessibility metrics
    • qualityMetrics Skill proficiency levels and competency assessments
    • trainingPrograms Educational programs and skill development initiatives
    • supplyGaps Talent shortages and skill deficiencies in the market

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    object
    Description

    Supply insights analysis data containing:

    • taskId (string): Unique identifier for the analyzed task
    • taskName (string): Name of the analyzed task
    • dataSource (string): Source of supply data (e.g., "Lightcast (via skill correlations)")
    • lastUpdated (string): ISO timestamp of last data update
    • correlatedSkills (array): Array of correlated skills with supply metrics
    • aggregatedSupply (object): Aggregated supply metrics with confidence scores
    • qualityMetrics (object): Quality assessment metrics for the supply data

Request

GET
/v1/ja/tasks/analytics/supply
curl "https://frontier.beamery.com/v1/ja/tasks/analytics/supply?taskId=c3d4e5f6-a7b8-9012-cdef-345678901234&jobFamilyGroup=Engineering&sections=availability,qualityMetrics" \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "analytics": {
    "taskId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "taskName": "System Architecture",
    "dataSource": "Lightcast (via skill correlations)",
    "lastUpdated": "2024-01-15T10:30:00Z",
    "correlatedSkills": [
      {
        "skillId": "f5a6b7c8-d9e0-1234-fabc-678901234567",
        "skillName": "System Design",
        "correlationStrength": 95,
        "supplyMetrics": {
          "totalCandidates": 35000,
          "activelyLooking": 8500,
          "averageExperience": 7.2
        }
      },
      {
        "skillId": "a6b7c8d9-e0f1-2345-abcd-789012345678",
        "skillName": "Cloud Architecture",
        "correlationStrength": 88,
        "supplyMetrics": {
          "totalCandidates": 32000,
          "activelyLooking": 9500,
          "averageExperience": 6.4
        }
      }
    ],
    "aggregatedSupply": {
      "weightedCandidates": 67000,
      "weightedActivelyLooking": 18000,
      "confidenceScore": 0.87,
      "seniorityDistribution": {
        "Executive": 1200,
        "Mid-Senior": 24000
      }
    },
    "qualityMetrics": {
      "averageExperience": 6.8,
      "certificationRate": 42.3,
      "skillProficiency": {
        "beginner": 28.5,
        "intermediate": 45.2,
        "advanced": 26.3
      }
    }
  }
}
InternalGET/v1/ja/tasks/{taskId}/correlations

Task correlations

Analyze comprehensive correlations between specific task, skills, roles, and job family groups with seniority level insights.

Path Parameters

  • Name
    taskId
    Type
    string
    Description

    Unique identifier for the task

Query Parameters

  • Name
    jobFamilyGroup
    Type
    string
    Description

    Filter by specific job family group (e.g., "Engineering", "Sales", "Marketing")

  • Name
    seniorityLevel
    Type
    string
    Description

    Filter by seniority level (e.g., "Executive", "Director", "Mid-Senior")

  • Name
    sections
    Type
    string
    Description

    Comma-separated list of sections to include. If omitted, returns all sections:

    • skills Related skills and competencies analysis
    • roles Connected job roles and position requirements
    • tasks Similar and complementary task relationships
    • jobFamilyGroups Associated job family group connections

Response

  • Name
    success
    Type
    boolean
    Description

    Request success status

  • Name
    data
    Type
    object
    Description

    Comprehensive correlation analysis data containing:

    • taskId (string): Unique identifier for the analyzed task
    • taskName (string): Name of the analyzed task
    • dataSource (string): Source of correlation data (e.g., "Beamery Knowledge Graph")
    • lastUpdated (string): ISO timestamp of last data update
    • skills (array): Array of correlated skills with correlation strengths
    • roles (array): Array of correlated roles with correlation strengths

Request

GET
/v1/ja/tasks/{taskId}/correlations
curl "https://frontier.beamery.com/v1/ja/tasks/a1b2c3d4-e5f6-7890-abcd-1234567890ab/correlations?jobFamilyGroup=Engineering&sections=skills,roles" \
  -H "Authorization: Bearer your_access_token"

Response

{
  "success": true,
  "correlations": {
    "taskId": "a1b2c3d4-e5f6-7890-abcd-1234567890ab",
    "taskName": "API Development",
    "dataSource": "Lightcast",
    "lastUpdated": "2024-01-15T10:30:00Z",
    "skills": [
      {
        "skillId": "b2c3d4e5-f6a7-8901-bcde-2345678901bc",
        "skillName": "JavaScript",
        "correlationStrength": 95,
        "correlationType": "essential",
        "reasoning": "Core technology for API development and implementation",
        "isSkillGap": false,
        "seniorityDistribution": {
          "Executive": 2.1,
          "Mid-Senior": 45.8
        }
      },
      {
        "skillId": "c3d4e5f6-a7b8-9012-cdef-345678901234",
        "skillName": "Database Design",
        "correlationStrength": 85,
        "correlationType": "supportive",
        "reasoning": "Critical for designing efficient data storage solutions",
        "isSkillGap": true,
        "seniorityDistribution": {
          "Executive": 8.2,
          "Mid-Senior": 38.5
        }
      }
    ],
    "roles": [
      {
        "roleId": "d4e5f6a7-b8c9-0123-defa-456789012345",
        "roleTitle": "Backend Developer",
        "correlationStrength": 92,
        "jobFamilyGroup": "Engineering",
        "seniorityLevel": "Mid-Senior",
        "demandGrowth": 18.5,
        "averageSalary": 120000
      },
      {
        "roleId": "e5f6a7b8-c9d0-1234-efab-567890123456",
        "roleTitle": "API Architect",
        "correlationStrength": 88,
        "jobFamilyGroup": "Engineering",
        "seniorityLevel": "Executive",
        "demandGrowth": 25.3,
        "averageSalary": 185000
      }
    ]
  }
}