---
title: "Retrieve or search items"
method: POST
path: "/api/workspaces/{workspaceId}/items/search"
tags: ["CRUD", "Items"]
---

# Retrieve or search items

`POST /api/workspaces/{workspaceId}/items/search`

## Request

- Base URL: `https://app.airfocus.com`
- URL: `https://app.airfocus.com/api/workspaces/{workspaceId}/items/search`
- Auth: HTTP bearer

Returns all items or searches items by query. Always returns only items which are accessible by the current user.<br/>Requirements:<br/>- auth-client scopes: "workspace:read"<br/>- user permission: "read" or higher

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `actAsAdmin` boolean
- `offset` integer
- `limit` integer
- `from` integer
- `to` integer

## Request body

- ItemSearchQuery
  - `archived` boolean
  - `filter` union
    - ItemSearchQueryFilterAliasContain
      - `caseSensitive` boolean, required
      - `text` string, required
      - `type` 'alias:contain', required
    - ItemSearchQueryFilterAnd
      - `inner` ItemSearchQueryFilter[], required
      - `type` 'and', required
    - ItemSearchQueryFilterArchivedValue
      - `type` 'archived:value', required
      - `value` boolean, required
    - ItemSearchQueryFilterAssigneesContain
      - `type` 'assignees:contain', required
      - `user` union, required
        - UserRefUserGroupRefId
          - `id` string, uuid, required
          - `type` 'groupId', required
        - UserRefUserRefCurrent
          - `type` 'current', required
        - UserRefUserRefId
          - `id` string, uuid, required
          - `type` 'id', required
    - ItemSearchQueryFilterAssigneesContainsAll
      - `type` 'assignees:containsAll', required
      - `users` UserRef[], required
        - union
          - UserRefUserGroupRefId
            - `id` string, uuid, required
            - `type` 'groupId', required
          - UserRefUserRefCurrent
            - `type` 'current', required
          - UserRefUserRefId
            - `id` string, uuid, required
            - `type` 'id', required
    - ItemSearchQueryFilterAssigneesContainsAny
      - `type` 'assignees:containsAny', required
      - `users` UserRef[], required
        - union
          - UserRefUserGroupRefId
            - `id` string, uuid, required
            - `type` 'groupId', required
          - UserRefUserRefCurrent
            - `type` 'current', required
          - UserRefUserRefId
            - `id` string, uuid, required
            - `type` 'id', required
    - ItemSearchQueryFilterAssigneesDefined
      - `type` 'assignees:defined', required
    - ItemSearchQueryFilterCompletionTimeBetween
      - `end` integer, required: end range in days
      - `start` integer, required: start range in days
      - `type` 'completionTime:between', required
    - ItemSearchQueryFilterCreatedAtAbsolute
      - `mode` 'after' | 'afterOrOn' | 'before' | 'beforeOrOn', required
      - `type` 'createdAt:absolute', required
      - `value` ItemSearchQueryDateTimeFilterValue, required
        - `date` string, date, required
        - `time` string
        - `zoneId` string, required
    - ItemSearchQueryFilterCreatedAtRange
      - `from` string, date, required
      - `type` 'createdAt:range', required
      - `until` string, date, required
    - ItemSearchQueryFilterCreatedAtRelative
      - `anchor` union, required
        - ItemSearchQueryTimeAnchorDays
          - `count` integer, required
          - `type` 'days', required
        - ItemSearchQueryTimeAnchorMonths
          - `count` integer, required
          - `type` 'months', required
        - ItemSearchQueryTimeAnchorWeeks
          - `count` integer, required
          - `type` 'weeks', required
      - `type` 'createdAt:relative', required
    - ItemSearchQueryFilterDescriptionContain
      - `caseSensitive` boolean, required
      - `text` string, required
      - `type` 'description:contain', required
    - ItemSearchQueryFilterDescriptionDefined
      - `type` 'description:defined', required
    - ItemSearchQueryFilterFieldType
      - `fieldType` string, required
      - `filter` union, required
        - union
          - BooleanFieldTypeFilterDefined
            - `type` 'defined', required
          - BooleanFieldTypeFilterEqual
            - `boolean` boolean, required
            - `type` 'equal', required
        - union
          - DateFieldTypeFilterAfter
            - `date` string, date, required
            - `type` 'after', required
          - DateFieldTypeFilterAfterOrOn
            - `date` string, date, required
            - `type` 'afterOrOn', required
          - DateFieldTypeFilterBefore
            - `date` string, date, required
            - `type` 'before', required
          - DateFieldTypeFilterBeforeOrOn
            - `date` string, date, required
            - `type` 'beforeOrOn', required
          - DateFieldTypeFilterDefined
            - `type` 'defined', required
          - DateFieldTypeFilterRange
            - `from` string, date, required
            - `type` 'range', required
            - `until` string, date, required
          - DateFieldTypeFilterRelative
            - `anchor` union, required
              - …
            - `type` 'relative', required
        - union
          - DateRangeFieldTypeFilterDefined
            - `type` 'defined', required
          - DateRangeFieldTypeFilterEndBefore
            - `date` string, date, required
            - `type` 'endBefore', required
          - DateRangeFieldTypeFilterEndBeforeOrOn
            - `date` string, date, required
            - `type` 'endBeforeOrOn', required
          - DateRangeFieldTypeFilterStartAfter
            - `date` string, date, required
            - `type` 'startAfter', required
          - DateRangeFieldTypeFilterStartAfterOrOn
            - `date` string, date, required
            - `type` 'startAfterOrOn', required
        - union
          - FormSourceFieldTypeFilterContain
            - `itemId` string, uuid, required
            - `type` 'contain', required
          - FormSourceFieldTypeFilterDefined
            - `type` 'defined', required
        - FormsTargetFieldTypeFilter
          - `type` 'defined', required
        - union
          - HealthCheckInsConfidenceFieldFilterContainsAny
            - `type` 'containsAny', required
            - `values` HealthCheckInHealthCheckInsConfidence[], required
          - HealthCheckInsConfidenceFieldFilterDefined
            - `type` 'defined', required
        - union
          - InsightsFieldTypeFilterContain
            - `itemId` string, uuid, required
            - `type` 'contain', required
            - `workspaceId` string, uuid, required
          - InsightsFieldTypeFilterDefined
            - `type` 'defined', required
          - InsightsFieldTypeFilterEqual
            - `number` number, required
            - `type` 'scoreEqual', required
          - InsightsFieldTypeFilterGreaterThan
            - `number` number, required
            - `type` 'scoreGreaterThan', required
          - InsightsFieldTypeFilterGreaterThanOrEqual
            - `number` number, required
            - `type` 'scoreGreaterThanOrEqual', required
          - InsightsFieldTypeFilterLessThan
            - `number` number, required
            - `type` 'scoreLessThan', required
          - InsightsFieldTypeFilterLessThanOrEqual
            - `number` number, required
            - `type` 'scoreLessThanOrEqual', required
        - union
          - MilestoneFieldFilterAfter
            - `date` string, date, required
            - `type` 'after', required
          - MilestoneFieldFilterAfterOrOn
            - `date` string, date, required
            - `type` 'afterOrOn', required
          - MilestoneFieldFilterBefore
            - `date` string, date, required
            - `type` 'before', required
          - MilestoneFieldFilterBeforeOrOn
            - `date` string, date, required
            - `type` 'beforeOrOn', required
          - MilestoneFieldFilterContainsAll
            - `ids` string[], required
            - `type` 'containsAll', required
          - MilestoneFieldFilterContainsAny
            - `ids` string[], required
            - `type` 'containsAny', required
          - MilestoneFieldFilterDefined
            - `type` 'defined', required
          - MilestoneFieldFilterRange
            - `from` string, date, required
            - `type` 'range', required
            - `until` string, date, required
          - MilestoneFieldFilterRelative
            - `anchor` union, required
              - …
            - `type` 'relative', required
        - MirrorSourceFieldTypeFilter
          - `type` 'defined', required
        - MirrorTargetFieldTypeFilter
          - `type` 'defined', required
        - union
          - NumberFieldTypeLikeFilterDefined
            - `type` 'defined', required
          - NumberFieldTypeLikeFilterEqual
            - `number` number, required
            - `type` 'equal', required
          - NumberFieldTypeLikeFilterGreaterThan
            - `number` number, required
            - `type` 'greaterThan', required
          - NumberFieldTypeLikeFilterGreaterThanOrEqual
            - `number` number, required
            - `type` 'greaterThanOrEqual', required
          - NumberFieldTypeLikeFilterLessThan
            - `number` number, required
            - `type` 'lessThan', required
          - NumberFieldTypeLikeFilterLessThanOrEqual
            - `number` number, required
            - `type` 'lessThanOrEqual', required
        - union
          - OkrConfidenceFieldFilterContainsAny
            - `type` 'containsAny', required
            - `values` Confidence[], required
          - OkrConfidenceFieldFilterDefined
            - `type` 'defined', required
        - union
          - OkrKeyResultReferenceFieldFilterContainsAnyKeyResult
            - `keyResultId` string[], required
            - `type` 'containsAnyKeyResult', required
          - OkrKeyResultReferenceFieldFilterContainsAnyObjective
            - `objectiveItemId` string[], required
            - `type` 'containsAnyObjective', required
          - OkrKeyResultReferenceFieldFilterDefined
            - `type` 'defined', required
        - OkrKeyResultsFieldFilter
          - `type` 'defined', required
        - union
          - PeopleFieldTypeFilterContain
            - `type` 'contain', required
            - `user` union, required
              - …
          - PeopleFieldTypeFilterContainsAll
            - `type` 'containsAll', required
            - `users` UserRef[], required
              - …
          - PeopleFieldTypeFilterContainsAny
            - `type` 'containsAny', required
            - `users` UserRef[], required
              - …
          - PeopleFieldTypeFilterDefined
            - `type` 'defined', required
        - union
          - PortalFieldTypeFilterDefined
            - `type` 'defined', required
          - PortalFieldTypeFilterPublic
            - `type` 'public', required
        - PortfolioSourceFieldFilter
          - `type` 'defined', required
        - union
          - RichTextFieldTypeFilterContain
            - `caseSensitive` boolean
            - `text` string, required
            - `type` 'contain', required
          - RichTextFieldTypeFilterDefined
            - `type` 'defined', required
        - union
          - SelectFieldTypeFilterContain
            - `id` string, required
            - `type` 'contain', required
          - SelectFieldTypeFilterContainsAll
            - `ids` string[], required
            - `type` 'containsAll', required
          - SelectFieldTypeFilterContainsAny
            - `ids` string[], required
            - `type` 'containsAny', required
          - SelectFieldTypeFilterDefined
            - `type` 'defined', required
        - union
          - TextFieldTypeFilterContain
            - `caseSensitive` boolean
            - `text` string, required
            - `type` 'contain', required
          - TextFieldTypeFilterDefined
            - `type` 'defined', required
          - TextFieldTypeFilterEqual
            - `caseSensitive` boolean
            - `text` string, required
            - `type` 'equal', required
        - union
          - TimePeriodFieldFilterContainsAll
            - `timePeriods` TimePeriodRef[], required
              - …
            - `type` 'containsAll', required
          - TimePeriodFieldFilterContainsAny
            - `timePeriods` TimePeriodRef[], required
              - …
            - `type` 'containsAny', required
          - TimePeriodFieldFilterDefined
            - `type` 'defined', required
          - TimePeriodFieldFilterEndBefore
            - `date` string, date, required
            - `type` 'endBefore', required
          - TimePeriodFieldFilterEndBeforeOrOn
            - `date` string, date, required
            - `type` 'endBeforeOrOn', required
          - TimePeriodFieldFilterEndsBeforeEndOf
            - `timePeriod` union, required
              - …
            - `type` 'endsBeforeEndOf', required
          - TimePeriodFieldFilterEndsBeforeStartOf
            - `timePeriod` union, required
              - …
            - `type` 'endsBeforeStartOf', required
          - TimePeriodFieldFilterStartAfter
            - `date` string, date, required
            - `type` 'startAfter', required
          - TimePeriodFieldFilterStartAfterOrOn
            - `date` string, date, required
            - `type` 'startAfterOrOn', required
          - TimePeriodFieldFilterStartsAfterEndOf
            - `timePeriod` union, required
              - …
            - `type` 'startsAfterEndOf', required
          - TimePeriodFieldFilterStartsFromStartOf
            - `timePeriod` union, required
              - …
            - `type` 'startsFromStartOf', required
        - union
          - VotingAppVotesFieldTypeFilterContainsAllUsers
            - `ids` string[], required
            - `type` 'containsAllUsers', required
          - VotingAppVotesFieldTypeFilterContainsAnyUsers
            - `ids` string[], required
            - `type` 'containsAnyUsers', required
          - VotingAppVotesFieldTypeFilterDefined
            - `type` 'defined', required
      - `type` 'field:type', required
    - ItemSearchQueryFilterFieldValue
      - `fieldId` string, uuid, required
      - `filter` union, required
        - union
          - BooleanFieldTypeFilterDefined
            - `type` 'defined', required
          - BooleanFieldTypeFilterEqual
            - `boolean` boolean, required
            - `type` 'equal', required
        - union
          - DateFieldTypeFilterAfter
            - `date` string, date, required
            - `type` 'after', required
          - DateFieldTypeFilterAfterOrOn
            - `date` string, date, required
            - `type` 'afterOrOn', required
          - DateFieldTypeFilterBefore
            - `date` string, date, required
            - `type` 'before', required
          - DateFieldTypeFilterBeforeOrOn
            - `date` string, date, required
            - `type` 'beforeOrOn', required
          - DateFieldTypeFilterDefined
            - `type` 'defined', required
          - DateFieldTypeFilterRange
            - `from` string, date, required
            - `type` 'range', required
            - `until` string, date, required
          - DateFieldTypeFilterRelative
            - `anchor` union, required
              - …
            - `type` 'relative', required
        - union
          - DateRangeFieldTypeFilterDefined
            - `type` 'defined', required
          - DateRangeFieldTypeFilterEndBefore
            - `date` string, date, required
            - `type` 'endBefore', required
          - DateRangeFieldTypeFilterEndBeforeOrOn
            - `date` string, date, required
            - `type` 'endBeforeOrOn', required
          - DateRangeFieldTypeFilterStartAfter
            - `date` string, date, required
            - `type` 'startAfter', required
          - DateRangeFieldTypeFilterStartAfterOrOn
            - `date` string, date, required
            - `type` 'startAfterOrOn', required
        - union
          - FormSourceFieldTypeFilterContain
            - `itemId` string, uuid, required
            - `type` 'contain', required
          - FormSourceFieldTypeFilterDefined
            - `type` 'defined', required
        - FormsTargetFieldTypeFilter
          - `type` 'defined', required
        - union
          - HealthCheckInsConfidenceFieldFilterContainsAny
            - `type` 'containsAny', required
            - `values` HealthCheckInHealthCheckInsConfidence[], required
          - HealthCheckInsConfidenceFieldFilterDefined
            - `type` 'defined', required
        - union
          - InsightsFieldTypeFilterContain
            - `itemId` string, uuid, required
            - `type` 'contain', required
            - `workspaceId` string, uuid, required
          - InsightsFieldTypeFilterDefined
            - `type` 'defined', required
          - InsightsFieldTypeFilterEqual
            - `number` number, required
            - `type` 'scoreEqual', required
          - InsightsFieldTypeFilterGreaterThan
            - `number` number, required
            - `type` 'scoreGreaterThan', required
          - InsightsFieldTypeFilterGreaterThanOrEqual
            - `number` number, required
            - `type` 'scoreGreaterThanOrEqual', required
          - InsightsFieldTypeFilterLessThan
            - `number` number, required
            - `type` 'scoreLessThan', required
          - InsightsFieldTypeFilterLessThanOrEqual
            - `number` number, required
            - `type` 'scoreLessThanOrEqual', required
        - union
          - MilestoneFieldFilterAfter
            - `date` string, date, required
            - `type` 'after', required
          - MilestoneFieldFilterAfterOrOn
            - `date` string, date, required
            - `type` 'afterOrOn', required
          - MilestoneFieldFilterBefore
            - `date` string, date, required
            - `type` 'before', required
          - MilestoneFieldFilterBeforeOrOn
            - `date` string, date, required
            - `type` 'beforeOrOn', required
          - MilestoneFieldFilterContainsAll
            - `ids` string[], required
            - `type` 'containsAll', required
          - MilestoneFieldFilterContainsAny
            - `ids` string[], required
            - `type` 'containsAny', required
          - MilestoneFieldFilterDefined
            - `type` 'defined', required
          - MilestoneFieldFilterRange
            - `from` string, date, required
            - `type` 'range', required
            - `until` string, date, required
          - MilestoneFieldFilterRelative
            - `anchor` union, required
              - …
            - `type` 'relative', required
        - MirrorSourceFieldTypeFilter
          - `type` 'defined', required
        - MirrorTargetFieldTypeFilter
          - `type` 'defined', required
        - union
          - NumberFieldTypeLikeFilterDefined
            - `type` 'defined', required
          - NumberFieldTypeLikeFilterEqual
            - `number` number, required
            - `type` 'equal', required
          - NumberFieldTypeLikeFilterGreaterThan
            - `number` number, required
            - `type` 'greaterThan', required
          - NumberFieldTypeLikeFilterGreaterThanOrEqual
            - `number` number, required
            - `type` 'greaterThanOrEqual', required
          - NumberFieldTypeLikeFilterLessThan
            - `number` number, required
            - `type` 'lessThan', required
          - NumberFieldTypeLikeFilterLessThanOrEqual
            - `number` number, required
            - `type` 'lessThanOrEqual', required
        - union
          - OkrConfidenceFieldFilterContainsAny
            - `type` 'containsAny', required
            - `values` Confidence[], required
          - OkrConfidenceFieldFilterDefined
            - `type` 'defined', required
        - union
          - OkrKeyResultReferenceFieldFilterContainsAnyKeyResult
            - `keyResultId` string[], required
            - `type` 'containsAnyKeyResult', required
          - OkrKeyResultReferenceFieldFilterContainsAnyObjective
            - `objectiveItemId` string[], required
            - `type` 'containsAnyObjective', required
          - OkrKeyResultReferenceFieldFilterDefined
            - `type` 'defined', required
        - OkrKeyResultsFieldFilter
          - `type` 'defined', required
        - union
          - PeopleFieldTypeFilterContain
            - `type` 'contain', required
            - `user` union, required
              - …
          - PeopleFieldTypeFilterContainsAll
            - `type` 'containsAll', required
            - `users` UserRef[], required
              - …
          - PeopleFieldTypeFilterContainsAny
            - `type` 'containsAny', required
            - `users` UserRef[], required
              - …
          - PeopleFieldTypeFilterDefined
            - `type` 'defined', required
        - union
          - PortalFieldTypeFilterDefined
            - `type` 'defined', required
          - PortalFieldTypeFilterPublic
            - `type` 'public', required
        - PortfolioSourceFieldFilter
          - `type` 'defined', required
        - union
          - RichTextFieldTypeFilterContain
            - `caseSensitive` boolean
            - `text` string, required
            - `type` 'contain', required
          - RichTextFieldTypeFilterDefined
            - `type` 'defined', required
        - union
          - SelectFieldTypeFilterContain
            - `id` string, required
            - `type` 'contain', required
          - SelectFieldTypeFilterContainsAll
            - `ids` string[], required
            - `type` 'containsAll', required
          - SelectFieldTypeFilterContainsAny
            - `ids` string[], required
            - `type` 'containsAny', required
          - SelectFieldTypeFilterDefined
            - `type` 'defined', required
        - union
          - TextFieldTypeFilterContain
            - `caseSensitive` boolean
            - `text` string, required
            - `type` 'contain', required
          - TextFieldTypeFilterDefined
            - `type` 'defined', required
          - TextFieldTypeFilterEqual
            - `caseSensitive` boolean
            - `text` string, required
            - `type` 'equal', required
        - union
          - TimePeriodFieldFilterContainsAll
            - `timePeriods` TimePeriodRef[], required
              - …
            - `type` 'containsAll', required
          - TimePeriodFieldFilterContainsAny
            - `timePeriods` TimePeriodRef[], required
              - …
            - `type` 'containsAny', required
          - TimePeriodFieldFilterDefined
            - `type` 'defined', required
          - TimePeriodFieldFilterEndBefore
            - `date` string, date, required
            - `type` 'endBefore', required
          - TimePeriodFieldFilterEndBeforeOrOn
            - `date` string, date, required
            - `type` 'endBeforeOrOn', required
          - TimePeriodFieldFilterEndsBeforeEndOf
            - `timePeriod` union, required
              - …
            - `type` 'endsBeforeEndOf', required
          - TimePeriodFieldFilterEndsBeforeStartOf
            - `timePeriod` union, required
              - …
            - `type` 'endsBeforeStartOf', required
          - TimePeriodFieldFilterStartAfter
            - `date` string, date, required
            - `type` 'startAfter', required
          - TimePeriodFieldFilterStartAfterOrOn
            - `date` string, date, required
            - `type` 'startAfterOrOn', required
          - TimePeriodFieldFilterStartsAfterEndOf
            - `timePeriod` union, required
              - …
            - `type` 'startsAfterEndOf', required
          - TimePeriodFieldFilterStartsFromStartOf
            - `timePeriod` union, required
              - …
            - `type` 'startsFromStartOf', required
        - union
          - VotingAppVotesFieldTypeFilterContainsAllUsers
            - `ids` string[], required
            - `type` 'containsAllUsers', required
          - VotingAppVotesFieldTypeFilterContainsAnyUsers
            - `ids` string[], required
            - `type` 'containsAnyUsers', required
          - VotingAppVotesFieldTypeFilterDefined
            - `type` 'defined', required
      - `type` 'field:value', required
    - ItemSearchQueryFilterIdAny
      - `type` 'id:any', required
      - `values` string[], required
    - ItemSearchQueryFilterIntegrationDefined
      - `type` 'integration:defined', required
    - ItemSearchQueryFilterIntegrationValue
      - `integrationId` string, uuid, required
      - `type` 'integration:value', required
    - ItemSearchQueryFilterItemWatchSelf
      - `type` 'item:watchSelf', required
    - ItemSearchQueryFilterLastUpdatedAtAbsolute
      - `mode` 'after' | 'afterOrOn' | 'before' | 'beforeOrOn', required
      - `property` union
        - 'archived' | 'assignees' | 'color' | 'createdAt' | 'creator' | 'description' | 'id' | 'lastUpdatedAt' | 'name' | 'number' | 'order' | 'status' | 'statusCategoryUpdatedAt' | 'statusUpdatedAt' | 'workspace'
        - string: A combination of 'fieldid:' prefix and a UUID field-id.
      - `type` 'lastUpdatedAt:absolute', required
      - `value` ItemSearchQueryDateTimeFilterValue, required
        - `date` string, date, required
        - `time` string
        - `zoneId` string, required
    - ItemSearchQueryFilterLastUpdatedAtRange
      - `from` string, date, required
      - `property` union
        - 'archived' | 'assignees' | 'color' | 'createdAt' | 'creator' | 'description' | 'id' | 'lastUpdatedAt' | 'name' | 'number' | 'order' | 'status' | 'statusCategoryUpdatedAt' | 'statusUpdatedAt' | 'workspace'
        - string: A combination of 'fieldid:' prefix and a UUID field-id.
      - `type` 'lastUpdatedAt:range', required
      - `until` string, date, required
    - ItemSearchQueryFilterLastUpdatedAtRelative
      - `anchor` union, required
        - ItemSearchQueryTimeAnchorDays
          - `count` integer, required
          - `type` 'days', required
        - ItemSearchQueryTimeAnchorMonths
          - `count` integer, required
          - `type` 'months', required
        - ItemSearchQueryTimeAnchorWeeks
          - `count` integer, required
          - `type` 'weeks', required
      - `property` union
        - 'archived' | 'assignees' | 'color' | 'createdAt' | 'creator' | 'description' | 'id' | 'lastUpdatedAt' | 'name' | 'number' | 'order' | 'status' | 'statusCategoryUpdatedAt' | 'statusUpdatedAt' | 'workspace'
        - string: A combination of 'fieldid:' prefix and a UUID field-id.
      - `type` 'lastUpdatedAt:relative', required
    - ItemSearchQueryFilterNameContain
      - `caseSensitive` boolean, required
      - `text` string, required
      - `type` 'name:contain', required
    - ItemSearchQueryFilterNameEqual
      - `caseSensitive` boolean, required
      - `text` string, required
      - `type` 'name:equal', required
    - ItemSearchQueryFilterNot
      - `inner` ItemSearchQueryFilter, required (recursive)
      - `type` 'not', required
    - ItemSearchQueryFilterOr
      - `inner` ItemSearchQueryFilter[], required
      - `type` 'or', required
    - ItemSearchQueryFilterParentDefined
      - `type` 'parent:defined', required
    - ItemSearchQueryFilterParentValue
      - `itemId` string, uuid, required
      - `type` 'parent:value', required
      - `workspaceId` string, uuid, required
    - ItemSearchQueryFilterStatusCategoryContainsAny
      - `categories` StatusCategory[], required
      - `type` 'statusCategory:containsAny', required
    - ItemSearchQueryFilterStatusCategoryUpdatedBetween
      - `end` string, date, required
      - `start` string, date, required
      - `type` 'statusCategory:updatedBetween', required
    - ItemSearchQueryFilterStatusCategoryUpdatedSince
      - `type` 'statusCategory:updatedSince', required
      - `value` union, required
        - ItemSearchQueryTimeAnchorDays
          - `count` integer, required
          - `type` 'days', required
        - ItemSearchQueryTimeAnchorMonths
          - `count` integer, required
          - `type` 'months', required
        - ItemSearchQueryTimeAnchorWeeks
          - `count` integer, required
          - `type` 'weeks', required
    - ItemSearchQueryFilterStatusContainsAny
      - `statusIds` string[], required
      - `type` 'status:containsAny', required
    - ItemSearchQueryFilterStatusUpdatedSince
      - `type` 'status:updatedSince', required
      - `value` union, required
        - ItemSearchQueryTimeAnchorDays
          - `count` integer, required
          - `type` 'days', required
        - ItemSearchQueryTimeAnchorMonths
          - `count` integer, required
          - `type` 'months', required
        - ItemSearchQueryTimeAnchorWeeks
          - `count` integer, required
          - `type` 'weeks', required
    - ItemSearchQueryFilterUpdatedSince
      - `property` union
        - 'archived' | 'assignees' | 'color' | 'createdAt' | 'creator' | 'description' | 'id' | 'lastUpdatedAt' | 'name' | 'number' | 'order' | 'status' | 'statusCategoryUpdatedAt' | 'statusUpdatedAt' | 'workspace'
        - string: A combination of 'fieldid:' prefix and a UUID field-id.
      - `timestamp` string, date-time, required
      - `type` 'updated:since', required
    - ItemSearchQueryFilterWorkspaceContains
      - `id` string, uuid, required
      - `type` 'workspace:contains', required
    - ItemSearchQueryFilterWorkspaceContainsAny
      - `type` 'workspace:containsAny', required
      - `workspaceIds` string[], required
  - `sort` union
    - ItemSearchQuerySortCreatedAt
      - `direction` 'asc' | 'desc', required
      - `type` 'createdAt', required
    - ItemSearchQuerySortField
      - `direction` 'asc' | 'desc', required
      - `fieldId` string, uuid, required
      - `type` 'field', required
    - ItemSearchQuerySortFieldType
      - `direction` 'asc' | 'desc', required
      - `fieldType` string, required
      - `type` 'fieldType', required
    - ItemSearchQuerySortLastUpdatedAt
      - `direction` 'asc' | 'desc', required
      - `type` 'lastUpdatedAt', required
    - ItemSearchQuerySortName
      - `direction` 'asc' | 'desc', required
      - `type` 'name', required
    - ItemSearchQuerySortOrder
      - `direction` 'asc' | 'desc', required
      - `type` 'order', required
    - ItemSearchQuerySortParent
      - `direction` 'asc' | 'desc', required
      - `type` 'parent', required
    - ItemSearchQuerySortStatus
      - `direction` 'asc' | 'desc', required
      - `type` 'status', required

## Response `200`

- ItemWithItemEmbedPage
  - `items` ItemWithItemEmbed[], required
    - `_embedded` ItemEmbed, required
      - `alias` string
      - `apps` object, required
      - `attachmentCount` integer, required
      - `children` RelativeItemInfo[], required
        - `alias` string
        - `childOrder` integer, required
        - `item` Item
          - `archived` boolean, required: Whether this item is archived.
          - `assigneeUserGroupIds` string[], required: Ids of user groups that are assigned to this item.
          - `assigneeUserIds` string[], required: Ids of users who are assigned to this item.
          - `color` 'amber' | 'azure' | 'black' | 'blue' | 'coco' | 'daulphine' | 'emerald' | 'fanta' | 'granite' | 'great' | 'leaf' | 'moss' | 'mutedAmber' | 'mutedAzure' | 'mutedBlack' | 'mutedBlue' | 'mutedCoco' | 'mutedDaulphine' | 'mutedEmerald' | 'mutedFanta' | 'mutedGranite' | 'mutedGreat' | 'mutedLeaf' | 'mutedMoss' | 'mutedOcean' | 'mutedOrange' | 'mutedPink' | 'mutedPurple' | 'mutedRed' | 'mutedSky' | 'mutedViolet' | 'mutedYellow' | 'ocean' | 'orange' | 'pink' | 'purple' | 'red' | 'sky' | 'violet' | 'yellow', required
          - `createdAt` string, date-time, required: Timestamp of when this item was created.
          - `creator` union
            - ActorAiActor
              - …
            - ActorApp
              - …
            - ActorIntegration
              - …
            - ActorShareLink
              - …
            - ActorSystem
              - …
            - ActorUser
              - …
          - `description` RichText, required
            - `blocks` RichTextBlock[], required
              - …
          - `fields` object, required: Values of custom fields, where each key is a custom-field ID and each value is a JSON-formatted value of the corresponding field.
          - `id` string, uuid, required: Unique identifier of this item.
          - `lastUpdatedAt` string, date-time, required: Timestamp of when this item was last updated.
          - `name` string, required: Name (title) of this item.
          - `number` integer: A numeric id of this item, which is used to create an alias to this item like DEV-123. The number is unique within the workspace, and defined by server on item creation.
          - `order` integer, required: A order number of this item for sorting.
          - `statusCategoryUpdatedAt` string, date-time: Timestamp of when the status of this item was last time switched from one category to another.
          - `statusId` string, uuid, required: Id of the status of this item.
          - `statusUpdatedAt` string, date-time: Timestamp of when the status of this item was last updated.
          - `workspaceId` string, uuid, required: Id of the workspace this workspace belongs to.
        - `itemId` string, uuid, required
        - `itemType` 'bug' | 'epic' | 'experiment' | 'feature' | 'feedback' | 'idea' | 'initiative' | 'app:okr:objective' | 'opportunity' | 'product' | 'project' | 'story' | 'task'
        - `parentOrder` integer, required
        - `relationId` string, uuid, required
        - `workspaceId` string, uuid, required
      - `commentCount` integer, required
      - `constraints` ItemConstraint[], required
        - union
          - ItemConstraintIntegrationPushForbidden
            - `extensionId` string, uuid, required
            - `type` 'integrationPushForbidden', required
          - ItemConstraintIntegrationToInternal
            - `extensionId` string, uuid, required
            - `property` union, required
              - …
            - `type` 'integrationToInternal', required
          - ItemConstraintPropertyReadOnly
            - `extensionId` string, uuid, required
            - `property` union, required
              - …
            - `type` 'propertyReadOnly', required
          - ItemConstraintUndeletable
            - `extensionId` string, uuid, required
            - `type` 'undeletable', required
      - `fieldEditMetadata` object: Who last edited each field of this item, and when. Absent when not retrieved.
      - `integration` ItemEmbedIntegration
        - `data` unknown, required
        - `id` string, uuid, required
        - `typeId` string, required
      - `linkCount` integer, required
      - `parents` RelativeItemInfo[], required
        - `alias` string
        - `childOrder` integer, required
        - `item` Item
          - `archived` boolean, required: Whether this item is archived.
          - `assigneeUserGroupIds` string[], required: Ids of user groups that are assigned to this item.
          - `assigneeUserIds` string[], required: Ids of users who are assigned to this item.
          - `color` 'amber' | 'azure' | 'black' | 'blue' | 'coco' | 'daulphine' | 'emerald' | 'fanta' | 'granite' | 'great' | 'leaf' | 'moss' | 'mutedAmber' | 'mutedAzure' | 'mutedBlack' | 'mutedBlue' | 'mutedCoco' | 'mutedDaulphine' | 'mutedEmerald' | 'mutedFanta' | 'mutedGranite' | 'mutedGreat' | 'mutedLeaf' | 'mutedMoss' | 'mutedOcean' | 'mutedOrange' | 'mutedPink' | 'mutedPurple' | 'mutedRed' | 'mutedSky' | 'mutedViolet' | 'mutedYellow' | 'ocean' | 'orange' | 'pink' | 'purple' | 'red' | 'sky' | 'violet' | 'yellow', required
          - `createdAt` string, date-time, required: Timestamp of when this item was created.
          - `creator` union
            - ActorAiActor
              - …
            - ActorApp
              - …
            - ActorIntegration
              - …
            - ActorShareLink
              - …
            - ActorSystem
              - …
            - ActorUser
              - …
          - `description` RichText, required
            - `blocks` RichTextBlock[], required
              - …
          - `fields` object, required: Values of custom fields, where each key is a custom-field ID and each value is a JSON-formatted value of the corresponding field.
          - `id` string, uuid, required: Unique identifier of this item.
          - `lastUpdatedAt` string, date-time, required: Timestamp of when this item was last updated.
          - `name` string, required: Name (title) of this item.
          - `number` integer: A numeric id of this item, which is used to create an alias to this item like DEV-123. The number is unique within the workspace, and defined by server on item creation.
          - `order` integer, required: A order number of this item for sorting.
          - `statusCategoryUpdatedAt` string, date-time: Timestamp of when the status of this item was last time switched from one category to another.
          - `statusId` string, uuid, required: Id of the status of this item.
          - `statusUpdatedAt` string, date-time: Timestamp of when the status of this item was last updated.
          - `workspaceId` string, uuid, required: Id of the workspace this workspace belongs to.
        - `itemId` string, uuid, required
        - `itemType` 'bug' | 'epic' | 'experiment' | 'feature' | 'feedback' | 'idea' | 'initiative' | 'app:okr:objective' | 'opportunity' | 'product' | 'project' | 'story' | 'task'
        - `parentOrder` integer, required
        - `relationId` string, uuid, required
        - `workspaceId` string, uuid, required
      - `progress` ItemEmbedProgress, required
        - `closed` integer, required
        - `total` integer, required
      - `watched` boolean, required
      - `workspaceItemType` 'bug' | 'epic' | 'experiment' | 'feature' | 'feedback' | 'idea' | 'initiative' | 'app:okr:objective' | 'opportunity' | 'product' | 'project' | 'story' | 'task'
    - `archived` boolean, required: Whether this item is archived.
    - `assigneeUserGroupIds` string[], required: Ids of user groups that are assigned to this item.
    - `assigneeUserIds` string[], required: Ids of users who are assigned to this item.
    - `color` 'amber' | 'azure' | 'black' | 'blue' | 'coco' | 'daulphine' | 'emerald' | 'fanta' | 'granite' | 'great' | 'leaf' | 'moss' | 'mutedAmber' | 'mutedAzure' | 'mutedBlack' | 'mutedBlue' | 'mutedCoco' | 'mutedDaulphine' | 'mutedEmerald' | 'mutedFanta' | 'mutedGranite' | 'mutedGreat' | 'mutedLeaf' | 'mutedMoss' | 'mutedOcean' | 'mutedOrange' | 'mutedPink' | 'mutedPurple' | 'mutedRed' | 'mutedSky' | 'mutedViolet' | 'mutedYellow' | 'ocean' | 'orange' | 'pink' | 'purple' | 'red' | 'sky' | 'violet' | 'yellow', required
    - `createdAt` string, date-time, required: Timestamp of when this item was created.
    - `creator` union
      - ActorAiActor
        - `actorType` union
          - 'assistant' | 'mcpServer'
          - string: An 'agent:' prefix followed by the specific agent type, e.g., 'agent:default:insights:create'
        - `id` string, uuid, required
        - `onBehalfOf` Actor, required (recursive)
        - `type` 'aiActor', required
      - ActorApp
        - `id` string, uuid, required
        - `onBehalfOf` Actor (recursive)
        - `type` 'app', required
        - `typeId` string
      - ActorIntegration
        - `id` string, uuid, required
        - `onBehalfOf` Actor (recursive)
        - `type` 'integration', required
        - `typeId` string
      - ActorShareLink
        - `type` 'shareLink', required
      - ActorSystem
        - `type` 'system', required
      - ActorUser
        - `id` string, uuid, required
        - `type` 'user', required
    - `description` RichText, required
      - `blocks` RichTextBlock[], required
        - union
          - RichTextBlockAttachment
            - `attachmentId` string, uuid, required
            - `caption` string
            - `contentType` string, required
            - `meta` object
            - `type` 'attachment', required
            - `width` integer
          - RichTextBlockBlockquote
            - `content` RichTextInline[], required
              - …
            - `meta` object
            - `type` 'blockquote', required
          - RichTextBlockCode
            - `content` string, required
            - `language` string
            - `meta` object
            - `type` 'code', required
          - RichTextBlockCustom
            - `id` string, required
            - `meta` object
            - `raw` string, required
            - `type` 'custom', required
          - RichTextBlockEmbed
            - `caption` string
            - `height` integer
            - `meta` object
            - `type` 'embed', required
            - `url` string, required
          - RichTextBlockHeadline
            - `content` RichTextInline[], required
              - …
            - `level` integer, required
            - `meta` object
            - `type` 'headline', required
          - RichTextBlockIndentation
            - `content` RichTextBlock[], required
            - `type` 'indentation', required
          - RichTextBlockList
            - `bulletListMarker` string
            - `items` RichTextListItem[], required
              - …
            - `meta` object
            - `ordered` boolean, required
            - `orderedListDelimiter` string
            - `orderedListStartsAt` integer
            - `type` 'list', required
          - RichTextBlockPanel
            - `colorHex` string
            - `content` RichTextBlock[], required
            - `title` string
            - `type` 'panel', required
          - RichTextBlockParagraph
            - `content` RichTextInline[], required
              - …
            - `meta` object
            - `type` 'paragraph', required
    - `fields` object, required: Values of custom fields, where each key is a custom-field ID and each value is a JSON-formatted value of the corresponding field.
    - `id` string, uuid, required: Unique identifier of this item.
    - `lastUpdatedAt` string, date-time, required: Timestamp of when this item was last updated.
    - `name` string, required: Name (title) of this item.
    - `number` integer: A numeric id of this item, which is used to create an alias to this item like DEV-123. The number is unique within the workspace, and defined by server on item creation.
    - `order` integer, required: A order number of this item for sorting.
    - `statusCategoryUpdatedAt` string, date-time: Timestamp of when the status of this item was last time switched from one category to another.
    - `statusId` string, uuid, required: Id of the status of this item.
    - `statusUpdatedAt` string, date-time: Timestamp of when the status of this item was last updated.
    - `workspaceId` string, uuid, required: Id of the workspace this workspace belongs to.
  - `totalItems` integer, required

## Other responses

- `400`: If payload is invalid.
- `401`: If missing authentication token.
- `403`: If user does not have the required permission, or authenticated client does not have the required access scopes.
- `default`: If any other error happens.

---

[API](https://skmtc.dev/airfocus/apis/airfocus-api.md) · [All operations](https://skmtc.dev/airfocus/apis/airfocus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/airfocus/apis/airfocus-api/revisions/fc9ccaa2ec6d?raw)