Get fields in trash paginated

Returns a paginated list of fields in the trash. The list may be restricted to fields whose field name or description partially match a string.

Only custom fields can be queried, type must be set to custom.

Permissions required: Administer Jira global permission.

{ "maxResults": 50, "startAt": 0, "total": 1, "isLast": false, "values": [ { "id": "customfield_10000", "name": "Approvers", "schema": { "type": "array", "custom": "com.atlassian.jira.plugin.system.customfieldtypes:multiuserpicker", "customId": 10003 }, "description": "Contains users needed for approval. This custom field was created by Jira Service Desk.", "key": "customfield_10003", "trashedDate": "2019-09-12T10:10:00.905+0000", "trashedBy": { "self": "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g", "accountId": "5b10a2844c20165700ede21g", "emailAddress": "mia@example.com", "avatarUrls": { "48x48": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48", "24x24": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24", "16x16": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16", "32x32": "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32" }, "displayName": "Mia Krystof", "active": true, "timeZone": "Australia/Sydney" }, "plannedDeletionDate": "2019-09-30T10:10:00.905+0000" } ] }

Request

Query Params

startAt

integer

optional

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

maxResults

integer

optional

The maximum number of items to return per page.

array[string]

optional

query

string

optional

String used to perform a case-insensitive partial match with field names or descriptions.

expand

string

optional

orderBy

string

optional

Order the results by a field:

name sorts by the field name

trashDate sorts by the date the field was moved to the trash

plannedDeletionDate sorts by the planned deletion date

Responses

🟢200Returned if the request is successful.

application/json

Body

A page of items.

isLast

boolean

read-onlyoptional

Whether this is the last page.

maxResults

integer <int32>

read-onlyoptional

The maximum number of items that could be returned.

string <uri>

read-onlyoptional

If there is another page of results, the URL of the next page.

self

string <uri>

read-onlyoptional

The URL of the page.

startAt

integer <int64>

read-onlyoptional

The index of the first item returned.

total

integer <int64>

read-onlyoptional

The number of items returned.

values

array[object (Field) {12}]

read-onlyoptional

The list of items.

contextsCount

integer <int64>

optional

Number of contexts where the field is used.

description

string

optional

The description of the field.

string

required

The ID of the field.

isLocked

boolean

optional

Whether the field is locked.

isUnscreenable

boolean

optional

Whether the field is shown on screen or not.

key

string

optional

The key of the field.

lastUsed

object (FieldLastUsed)

optional

Information about the most recent use of a field.

name

string

required

The name of the field.

projectsCount

integer <int64>

optional

Number of projects where the field is used.

schema

object (JsonTypeBean)

required

The schema of a field.

screensCount

integer <int64>

optional

Number of screens where the field is used.

searcherKey

string

optional

The searcher key of the field. Returned for custom fields.

🟠400Returned if the request is invalid.

🟠401Returned if the authentication credentials are incorrect or missing.

🟠403Returned if the user does not have the necessary permission.