jira.js
    Preparing search index...

    Function getCustomFieldConfiguration

    • Returns a paginated list of configurations for a custom field of a type created by a Forge app.

      The result can be filtered by one of these criteria:

      • id.
      • fieldContextId.
      • issueId.
      • projectKeyOrId and issueTypeId.

      Otherwise, all configurations are returned.

      Permissions required: Administer Jira global permission. Jira permissions are not required for the Forge app that provided the custom field type.

      Parameters

      • client: Client
      • parameters: {
            fieldContextId?: number[];
            fieldIdOrKey: string;
            id?: number[];
            issueId?: number;
            issueTypeId?: string;
            maxResults?: number;
            projectKeyOrId?: string;
            startAt?: number;
        }
        • OptionalfieldContextId?: number[]

          The list of field context IDs. To include multiple field contexts, separate IDs with an ampersand: fieldContextId=10000&fieldContextId=10001. Can't be provided with id, issueId, projectKeyOrId, or issueTypeId.

        • fieldIdOrKey: string

          The ID or key of the custom field, for example customfield_10000.

        • Optionalid?: number[]

          The list of configuration IDs. To include multiple configurations, separate IDs with an ampersand: id=10000&id=10001. Can't be provided with fieldContextId, issueId, projectKeyOrId, or issueTypeId.

        • OptionalissueId?: number

          The ID of the issue to filter results by. If the issue doesn't exist, an empty list is returned. Can't be provided with projectKeyOrId, or issueTypeId.

        • OptionalissueTypeId?: string

          The ID of the issue type to filter results by. Must be provided with projectKeyOrId. Can't be provided with issueId.

        • OptionalmaxResults?: number

          The maximum number of items to return per page.

        • OptionalprojectKeyOrId?: string

          The ID or key of the project to filter results by. Must be provided with issueTypeId. Can't be provided with issueId.

        • OptionalstartAt?: number

          The index of the first item to return in a page of results (page offset).

      • Optionaloptions: RequestOptions

      Returns Promise<
          {
              isLast: boolean;
              maxResults: number;
              nextPage?: string;
              self?: string;
              startAt: number;
              total: number;
              values: {
                  configuration?: unknown;
                  fieldContextId: string;
                  id: string;
                  schema?: unknown;
                  [key: string]: unknown;
              }[];
              [key: string]: unknown;
          },
      >