--- title: "Get default values for a custom field grouped by context and issue type" method: GET path: "/rest/api/3/field/{fieldId}/context/defaultValues" tags: ["Issue custom field contexts"] --- # Get default values for a custom field grouped by context and issue type `GET /rest/api/3/field/{fieldId}/context/defaultValues` Returns a paginated list of default values grouped by custom field context. Each returned `ContextDefaultValuesBean` has a `contextId` and a `defaultValues` list of `IssueTypeDefaultValueBean` entries - one per issue-type-scoped default value configured for the context. An entry with `"isAnyIssueType": true` represents the catch-all default that applies to every issue type covered by the context that is not covered by a more specific entry; a non-null `issueTypeId` represents a default that only applies to that issue type. For contexts that have not been converted to the multiple-contexts data model, exactly one entry is returned per context with `isAnyIssueType=true`. For converted contexts, one entry is returned per configured per-issue-type default. The value object on each entry is the same polymorphic `CustomFieldContextDefaultValueBean` exposed by the deprecated `GET /defaultValue` endpoint - its concrete subtype depends on the custom field's type (see the list of supported types on that endpoint). **[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg). ## Path parameters - `fieldId` string, required ## Query parameters - `contextId` integer[] - `issueTypeId` string[] - `startAt` integer - `maxResults` integer ## Response `200` Returned if the request is successful. - PageBeanContextDefaultValues — A page of items. - `isLast` boolean — Whether this is the last page. - `maxResults` integer — The maximum number of items that could be returned. - `nextPage` string, uri — If there is another page of results, the URL of the next page. - `self` string, uri — The URL of the page. - `startAt` integer — The index of the first item returned. - `total` integer — The number of items returned. - `values` ContextDefaultValues[] — The list of items. - `contextId` integer, required — The ID of the context. - `defaultValues` IssueTypeDefaultValue[] — Per-issue-type default values for this context. May contain a single entry for unconverted contexts, or one entry per issue type for converted contexts. - `isAnyIssueType` boolean, nullable — True when this default value applies to every issue type covered by the context (no specific issue type). Only present when true; omitted otherwise. - `issueTypeId` string, nullable — The ID of the issue type this default value applies to. Null when isAnyIssueType is true. - `value` union - object — The default value for a cascading select custom field. - `cascadingOptionId` string — The ID of the default cascading option. - `contextId` string, required — The ID of the context. - `optionId` string, required — The ID of the default option. - `type` string, required - object — The default value for a multi-select custom field. - `contextId` string, required — The ID of the context. - `optionIds` string[], required — The list of IDs of the default options. - `type` string, required - object — The default value for a single select custom field. - `contextId` string, required — The ID of the context. - `optionId` string, required — The ID of the default option. - `type` string, required - object — Defaults for a User Picker (single) custom field. - `accountId` string, required — The ID of the default user. - `contextId` string, required — The ID of the context. - `type` string, required - `userFilter` UserFilter, required — Filter for a User Picker (single) custom field. - `enabled` boolean, required — Whether the filter is enabled. - `groups` string[] — User groups autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 groups can be provided. - `roleIds` integer[] — Roles that autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 roles can be provided. - object — The default value for a User Picker (multiple) custom field. - `accountIds` string[], required — The IDs of the default users. - `contextId` string, required — The ID of the context. - `type` string, required - object — The default value for a group picker custom field. - `contextId` string, required — The ID of the context. - `groupId` string, required — The ID of the the default group. - `type` string, required - object — The default value for a multiple group picker custom field. - `contextId` string, required — The ID of the context. - `groupIds` string[], required — The IDs of the default groups. - `type` string, required - object — The default value for a Date custom field. - `contextId` string, required — The ID of the context. - `date` string — The default date in ISO format. Ignored if `useCurrent` is true. - `type` string, required - `useCurrent` boolean — Whether to use the current date. - object — The default value for a date time custom field. - `contextId` string, required — The ID of the context. - `dateTime` string — The default date-time in ISO format. Ignored if `useCurrent` is true. - `type` string, required - `useCurrent` boolean — Whether to use the current date. - object — The default value for a URL custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `url` string, required — The default URL. - object — The default value for a project custom field. - `contextId` string, required — The ID of the context. - `projectId` string, required — The ID of the default project. - `type` string, required - object — Default value for a float (number) custom field. - `contextId` string, required — The ID of the context. - `number` number, double, required — The default floating-point number. - `type` string, required - object — Default value for a labels custom field. - `contextId` string, required — The ID of the context. - `labels` string[], required — The default labels value. - `type` string, required - object — The default text for a text custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 254 characters. - `type` string, required - object — The default text for a text area custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 32767 characters. - `type` string, required - object — The default text for a read only custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 255 characters. - `type` string, required - object — The default value for a version picker custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `versionId` string, required — The ID of the default version. - `versionOrder` string — The order the pickable versions are displayed in. If not provided, the released-first order is used. Available version orders are `"releasedFirst"` and `"unreleasedFirst"`. - object — The default value for a multiple version picker custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `versionIds` string[], required — The IDs of the default versions. - `versionOrder` string — The order the pickable versions are displayed in. If not provided, the released-first order is used. Available version orders are `"releasedFirst"` and `"unreleasedFirst"`. - object — The default text for a Forge string custom field. - `contextId` string, required — The ID of the context. - `text` string — The default text. The maximum length is 254 characters. - `type` string, required - object — The default text for a Forge collection of strings custom field. - `contextId` string, required — The ID of the context. - `type` string, required - `values` string[] — List of string values. The maximum length for a value is 254 characters. - object — The default value for a Forge object custom field. - `contextId` string, required — The ID of the context. - `object` object — The default JSON object. - `type` string, required - object — The default value for a Forge date time custom field. - `contextId` string, required — The ID of the context. - `dateTime` string — The default date-time in ISO format. Ignored if `useCurrent` is true. - `type` string, required - `useCurrent` boolean — Whether to use the current date. - object — The default value for a Forge group custom field. - `contextId` string, required — The ID of the context. - `groupId` string, required — The ID of the the default group. - `type` string, required - object — The default value for a Forge collection of groups custom field. - `contextId` string, required — The ID of the context. - `groupIds` string[], required — The IDs of the default groups. - `type` string, required - object — Default value for a Forge number custom field. - `contextId` string, required — The ID of the context. - `number` number, double, required — The default floating-point number. - `type` string, required - object — Defaults for a Forge user custom field. - `accountId` string, required — The ID of the default user. - `contextId` string, required — The ID of the context. - `type` string, required - `userFilter` UserFilter, required — Filter for a User Picker (single) custom field. - `enabled` boolean, required — Whether the filter is enabled. - `groups` string[] — User groups autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 groups can be provided. - `roleIds` integer[] — Roles that autocomplete suggestion users must belong to. If not provided, the default values are used. A maximum of 10 roles can be provided. - object — Defaults for a Forge collection of users custom field. - `accountIds` string[], required — The IDs of the default users. - `contextId` string, required — The ID of the context. - `type` string, required ## Other responses - `401` — Returned if the authentication credentials are incorrect or missing. - `403` — Returned if the user does not have the required permissions. - `404` — Returned if the custom field is not found. --- [API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3.md) · [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api-3/revisions/9029bb1c5ebd/schema)