---
updatedAt: 2026-04-28T08:04:37.000Z
agentTools:
projectIndex: https://developers.wrike.com/llms.txt
---
# Get Work Schedule Capacity Changes (User)
Get all capacity changes for given users.
Scopes: amReadOnlyWorkSchedule, amReadWriteWorkSchedule
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Wrike API",
"version": "4.0"
},
"servers": [
{
"url": "https://www.wrike.com/api/v4"
},
{
"url": "https://app-eu.wrike.com/api/v4"
},
{
"url": "https://app-us2.wrike.com/api/v4"
}
],
"paths": {
"/user_schedule_capacity_change": {
"get": {
"tags": [
"User Schedule capacity changes"
],
"summary": "Get Work Schedule Capacity Changes (User)",
"description": "Get all capacity changes for given users.\n\nScopes: amReadOnlyWorkSchedule, amReadWriteWorkSchedule",
"operationId": "GET:/user_schedule_capacity_change/empty",
"parameters": [
{
"name": "userIds",
"in": "query",
"description": "User IDs to query",
"required": true,
"schema": {
"type": "string",
"description": "User IDs to query"
}
},
{
"name": "dateRange",
"in": "query",
"description": "Date range to query",
"required": true,
"schema": {
"type": "string",
"description": "Date range to query"
}
}
],
"responses": {
"2XX": {
"description": "success response",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"kind": {
"$ref": "#/components/schemas/ResponseKind"
},
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/UserScheduleCapacityChange"
}
}
}
}
}
}
},
"4XX": {
"description": "client-side error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
},
"5XX": {
"description": "server-side error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
},
"security": [
{
"HTTP": []
}
]
}
}
},
"components": {
"schemas": {
"ResponseKind": {
"type": "string",
"enum": [
"accounts",
"users",
"contacts",
"assets",
"eDiscoveryReport",
"folders",
"folderTree",
"tasks",
"taskIds",
"timelogs",
"timelogCategories",
"timelogLockPeriods",
"timetrackerTimers",
"comments",
"attachments",
"url",
"version",
"dataExport",
"dataExportSchema",
"auditLog",
"accessRoles",
"stream",
"changes",
"posts",
"mailSettings",
"integrationInfo",
"gmailIntegrationSettings",
"workTypesForIntegrations",
"ids",
"backups",
"domains",
"dependencies",
"workflows",
"workschedules",
"workscheduleExclusions",
"workscheduleUserExclusions",
"customfields",
"customfieldIds",
"customstatuses",
"invitations",
"notifications",
"jobroles",
"placeholders",
"groups",
"session",
"dashboards",
"widgets",
"taskCreationSettings",
"colors",
"experiments",
"topics",
"topicComments",
"webhooks",
"reviews",
"boards",
"textSearch",
"chatChannels",
"chatMessages",
"forms",
"requestForms",
"request",
"report",
"platformWidgets",
"platformWidgetInstances",
"spaces",
"pdf",
"customerSatisfaction",
"asyncJob",
"approvals",
"highlights",
"highlightsList",
"highlightsSettings",
"highlightsCard",
"timesheet",
"timesheetRow",
"timesheetSubmissionRule",
"mobileFeatures",
"mobileSettings",
"folderBlueprintTree",
"taskBlueprintTree",
"blueprintSearch",
"feedback",
"timeline_snapshot",
"contactIds",
"bookings",
"integrateThreshold",
"hourlyRatesProvision",
"hourlyRates",
"projectTeamMembers",
"contactsHistory",
"tasksHistory",
"foldersHistory",
"activityDigest",
"workItemTemplates",
"workTemplates",
"workItemMetadata",
"workItem",
"customItemTypes",
"verificationCode",
"views",
"listView",
"tableView",
"userTypes",
"reactions",
"externalRequesters",
"workscheduleCapacityOverrides",
"userCapacityOverrides",
"userCapacityExclusions",
"rollups",
"requestFormPrefill",
"mcpFeatures",
"attachmentUploadUrl",
"userAggregatedCapacity",
"cascadingFieldSettings",
"recommendResources",
"aggregatedAllocatedEffort",
"aggregatedTotalUserEffort",
"aggregatedTimeSpent",
"folderBlueprint",
"taskBlueprint"
]
},
"ErrorType": {
"type": "string",
"enum": [
"invalid_request",
"invalid_parameter",
"parameter_required",
"not_authorized",
"access_forbidden",
"not_allowed",
"resource_not_found",
"method_not_found",
"too_many_requests",
"rate_limit_exceeded",
"server_error"
]
},
"ErrorResponse": {
"type": "object",
"properties": {
"error": {
"$ref": "#/components/schemas/ErrorType"
},
"errorDescription": {
"type": "string"
}
}
},
"UserScheduleCapacityChange": {
"type": "object",
"properties": {
"finishDate": {
"type": "string",
"description": "
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
},
"id": {
"type": "string",
"description": ""
},
"userId": {
"$ref": "#/components/schemas/UserId"
},
"capacityMinutes": {
"type": "number",
"description": ""
},
"startDate": {
"type": "string",
"description": "
Format: yyyy-MM-dd'T'HH:mm:ss'Z'"
}
}
},
"UserId": {
"pattern": "^([A-Z0-9]){8}$",
"type": "string"
}
},
"securitySchemes": {
"HTTP": {
"type": "http",
"description": "Use OAuth 2.0 access token or permanent access token for authorization.",
"scheme": "bearer",
"bearerFormat": "JWT"
}
}
}
}
```