> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v80/llms.txt)

# Retrieve Folder Icons

> GET /profiles/{profile_id}/icons/{folder}
> 
> Lists the icons stored in one icon folder of the profile. Today the only folder is `drawing_custom_icons`, the custom icon set of the Drawing element. Icons in other folders (including the profile's default page icons served by `GET /profiles/{profile_id}/icons`) are not included.
> 
> ### Response
> 
> A plain JSON array of icon urls (strings), not objects.
> 
> ### Folder
> 
> `folder` must be exactly one of the allowed folder names; any other value, including dot segments, returns `404`.



## Servers
- https://api.iformbuilder.com/exzact/api/v80/[servername]: https://api.iformbuilder.com/exzact/api/v80/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (string)
  id of the profile

- **folder** (string)
  name of the icon folder


### Query parameters

- **limit** (integer)
  maximum number of urls to return (at most 1000, the default)



## Responses
### 200
OK - a JSON array of icon urls in the folder. The `Total-Count` response header carries the number of urls returned.
#### Headers

- **Total-Count** (integer)
  number of icon urls in the response


#### Body: application/json (array[string])
array[string]
### 400
Bad Request - `limit` or `offset` is not an integer.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - the caller cannot access this profile's resources, or `profile_id` is not the caller's own profile.

### 404
Not Found - `folder` is not an allowed icon folder, or `profile_id` does not exist.


[Powered by Bump.sh](https://bump.sh)
