1. Operations
2. content
3. library

## content library: find

Returns a list of all the visible (as determined by authorization policy) libraries matching the requested content.library.find_spec.

### Request:

#### HTTP request

POST https://{server}/rest/com/vmware/content/library?~action=find

#### Request Body Structure:

- JSON
- XML

{
"spec": {
"name": "string",
"type": "LOCAL"
}
}
<?xml version="1.0" ?>
<ns0:Find-Input xmlns:ns0="http://vmware.com/content/library" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<spec>
<name>string</name>
<type>LOCAL</type>
</spec>
</ns0:Find-Input>

#### Request Body Parameters:

Name | Type | Description
--- | --- | ---
bold = required
spec | find_spec | Specification describing what properties to filter on.
spec.name | string | Name of the library to search. The name is case-insensitive. See content.library_model.name. Optional. If not specified any name will be searched.
spec.type | string | Library type to search. See content.library_model.type. Optional. If not specified any library type will be searched.

### Response:

#### HTTP Status Code: 200

#### Representations:

- JSON
- XML

{
"value": [
"obj-103",
"obj-103"
]
}
<?xml version="1.0" ?>
<ns0:Find-Result xmlns:ns0="http://vmware.com/content/library" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<value-array>
<array-item>obj-103</array-item>
<array-item>obj-103</array-item>
</value-array>
</ns0:Find-Result>

#### Response Type:

Name | Type | Description
--- | --- | ---
bold = required
value | string[] | The array of identifiers of all the visible libraries matching the given `spec`.

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
400 | invalid_argument | if no properties are specified in the `spec`.