Skip to navigation
ReferenceAgent Project Service

List skills

Returns a paginated list of the skills the current user can read, optionally filtered by ID, name, description, creator, last updater, or creation or update time. Filters apply across all pages.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Query parameters

limitintegerOptional1-1000Defaults to 50
Page size.
skipintegerOptional>=0Defaults to 0
Number of Skills to skip.
sortenumOptionalDefaults to name
Field to sort by.
Allowed values:
orderenumOptionalDefaults to 1

1 for ascending, -1 for descending.

Allowed values:
searchstringOptional

Case-insensitive text the Skill name must contain.

idsstring or list of stringsOptional

Only these Skills. Skill ids (UUIDs), as a string, comma-separated, or an array; invalid ids are ignored, and no valid id lists nothing.

excludeIdsstring or list of stringsOptional
Never these Skills. Same format as ids.
createdByMeenumOptional
When "true", only Skills created by the calling user are listed. "false" is the same as omitting it.
Allowed values:
sharedWithMeenumOptional
When "true", only Skills the calling user can read but did not create are listed. "false" is the same as omitting it.
Allowed values:
nameContainsstringOptional

Only Skills whose name contains this text, ignoring case. The text is literal; blank is the same as omitting it.

descriptionContainsstringOptional

Only Skills whose description contains this text, ignoring case. The text is literal; blank is the same as omitting it. Skills without a description never match.

createdByIdsstring or list of stringsOptional

Only Skills first created by one of these accounts. Account ids (_id hex strings, as stored), as a string, comma-separated, or an array. Omitted or empty is no filter; an id no Skill carries matches nothing.

updatedByIdsstring or list of stringsOptional
Only Skills whose current version was stored by one of these accounts. Same format as createdByIds.
createdFromstringOptional

Only Skills first created at or after this instant. ISO 8601 date and time with a UTC offset, such as 2025-03-04T00:00:00.000Z; blank is the same as omitting it.

createdTostringOptional
Only Skills first created at or before this instant. Same format as createdFrom. A createdFrom after createdTo lists nothing.
updatedFromstringOptional
Only Skills whose current version was stored at or after this instant. Same format as createdFrom.
updatedTostringOptional
Only Skills whose current version was stored at or before this instant. Same format as createdFrom. An updatedFrom after updatedTo lists nothing.

Response

Paginated list of Skills
messagestring
dataobject

Errors

500
Internal Server Error