# Get the users app preferences

**GET /preferences/{clientId}**

Requests the apps preferences for the user identified by the given token.
The preferences may only be returned if the client has the respective scope
or is identified by the `clientId`. In order words all clients have their own
preferences namespace, only with the respective scope e.g. `user:preferences:read:xyz`
a client might be able to read the preferences of a different client.


In case no preferences were ever set an empty object `{}` is returned.



## Servers
- Preview: https://api.pace.cloud/user/2022-1 (Preview)


## Authentication methods
- OAuth2
- Oidc


## Parameters

#### Path parameters
- **clientId** (string)
  The ID of the client for that the preferences should be read.



## Responses
### 200: Retrieves the persisted preferences

#### Body Parameters: application/json (object)
- **Additional properties are allowed** ()
  

### 401: OAuth token missing or invalid or a linked identity is missing.

Linked identity missing is a special case where you need to make sure that
the user has additionally logged in / authorized with a third-party.

This is not relevant for most use-cases.

The specific error code that identifies a missing linked identity is `missing-linked-identity`

Example:

```
  {
      "errors": [
          {
              "id": "cbgmhslmp1o9or9kh1p0",
              "title": "Missing linked identity for authorized access",
              "detail": "Linked identity is needed to access this resource, please check why the user does not have a linked identity",
              "status": "401",
              "code": "missing-linked-identity"
          }
      ]
  }
```


#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 403: Forbidden

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 404: Resource not found

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  

### 501: Internal server error

#### Body Parameters: application/vnd.api+json (object)
- **errors** (array[object])
  


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