POST /api/v1/meta/schemas/apps/{appId}/default
Updates the App User Schema. This updates, adds, or removes one or more custom profile properties or the nullability of a base property in the App User Schema for an app. Changing a base property's nullability (for example, the value of its required
field) is allowed only if it is nullable in the default predefined Schema for the App.
The User Types feature does not extend to apps. All users assigned to a given app use the same App User Schema. Therefore, unlike the User Schema operations, the App User Schema operations all specify default
and don't accept a Schema ID.
Servers
- https://{yourOktaDomain}
Path parameters
Name | Type | Required | Description |
---|---|---|---|
appId |
String | Yes |
Application ID |
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
id |
String | No |
URI of User Schema |
_links |
Object | No |
Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations. |
created |
String | No |
Timestamp when the Schema was created |
name |
String | No |
Name of the Schema |
title |
String | No |
User-defined display name for the Schema |
type |
String | No |
Type of root Schema |
$schema |
String | No |
JSON Schema version identifier |
lastUpdated |
String | No |
Timestamp when the Schema was last updated |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.