GET /api/v1/mappings

Lists all profile mappings in your organization with pagination. You can return a subset of profile mappings that match a supported sourceId and/or targetId. The results are paginated according to the limit parameter. If there are multiple pages of results, the Link header contains a next link that should be treated as an opaque value (follow it, don't parse it).

The response is a collection of profile mappings that include a subset of the profile mapping object's parameters. The profile mapping object describes the properties mapping between an Okta User and an App User Profile using JSON Schema Draft 4.

Servers

Query parameters

Name Type Required Description
limit Integer No

Specifies the number of results per page (maximum 200)

Default value: 20

after String No

Mapping id that specifies the pagination cursor for the next page of mappings

targetId String No

The UserType or App Instance id that acts as the target of expressions in a mapping. If this parameter is included, all returned mappings have this as their target.id.

sourceId String No

The UserType or App Instance id that acts as the source of expressions in a mapping. If this parameter is included, all returned mappings have this as their source.id.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.