--- id: create-access-profile sidebar_label: Create an Access Profile hide_title: true hide_table_of_contents: true api: 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 sidebar_class_name: "post api-method" info_path: docs/api/beta/identitynow-beta-api custom_edit_url: "https://github.com/sailpoint-oss/developer.sailpoint.com/issues/new?assignees=&labels=&template=bug-report.md&title=%5BBug%5D+Your+Bug+Report+Here Requesting changes to 'Create an Access Profile' (create-access-profile)" --- import ApiTabs from "@theme/ApiTabs"; import DiscriminatorTabs from "@theme/DiscriminatorTabs"; import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"; import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes"; import MimeTabs from "@theme/MimeTabs"; import ParamsItem from "@theme/ParamsItem"; import ResponseSamples from "@theme/ResponseSamples"; import SchemaItem from "@theme/SchemaItem"; import SchemaTabs from "@theme/SchemaTabs"; import TabItem from "@theme/TabItem";

Create an Access Profile

This API creates an Access Profile. A token with API, ORG_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API. In addition, a token with only ROLE_SUBADMIN or SOURCE_SUBADMIN authority must be associated with the Access Profile's Source. The maximum supported length for the description field is 2000 characters. Longer descriptions will be preserved for existing access profiles, however, any new access profiles as well as any updates to existing descriptions will be limited to 2000 characters. ## Request

Body

required
    owner objectrequired
    Owner of the Access Profile
    source objectrequired
    entitlements object[]nullable
    A list of entitlements associated with the Access Profile. If enabled is false this is allowed to be empty otherwise it needs to contain at least one Entitlement.
  • Array [
  • ]
  • accessRequestConfig objectnullable
    Access request configuration for this object
    approvalSchemes object[]nullable
    List describing the steps in approving the request
  • Array [
  • ]
  • revocationRequestConfig objectnullable
    Revocation request configuration for this object.
    approvalSchemes object[]nullable
    List describing the steps in approving the revocation request
  • Array [
  • ]
  • provisioningCriteria objectnullable
    When an Identity has multiple Accounts on the Source with which an Access Profile is associated, this expression is evaluated against those Accounts to choose one to provision with the Access Profile.
    children object[]nullable
    Array of child criteria. Required if the operation is AND or OR, otherwise it must be left null. A maximum of three levels of criteria are supported, including leaf nodes.
  • Array [
  • children object[]nullable
    Array of child criteria. Required if the operation is AND or OR, otherwise it must be left null. A maximum of three levels of criteria are supported, including leaf nodes.
  • Array [
  • ]
  • ]
Access Profile created
Schema
    owner objectrequired
    Owner of the Access Profile
    source objectrequired
    entitlements object[]nullable
    A list of entitlements associated with the Access Profile. If enabled is false this is allowed to be empty otherwise it needs to contain at least one Entitlement.
  • Array [
  • ]
  • accessRequestConfig objectnullable
    Access request configuration for this object
    approvalSchemes object[]nullable
    List describing the steps in approving the request
  • Array [
  • ]
  • revocationRequestConfig objectnullable
    Revocation request configuration for this object.
    approvalSchemes object[]nullable
    List describing the steps in approving the revocation request
  • Array [
  • ]
  • provisioningCriteria objectnullable
    When an Identity has multiple Accounts on the Source with which an Access Profile is associated, this expression is evaluated against those Accounts to choose one to provision with the Access Profile.
    children object[]nullable
    Array of child criteria. Required if the operation is AND or OR, otherwise it must be left null. A maximum of three levels of criteria are supported, including leaf nodes.
  • Array [
  • children object[]nullable
    Array of child criteria. Required if the operation is AND or OR, otherwise it must be left null. A maximum of three levels of criteria are supported, including leaf nodes.
  • Array [
  • ]
  • ]
Client Error - Returned if the request body is invalid.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]
Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.
Schema
Forbidden - Returned if the user you are running as, doesn't have access to this end-point.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 403 response object

Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.
Schema
Internal Server Error - Returned if there is an unexpected error.
Schema
    messages object[]
    Generic localized reason for error
  • Array [
  • ]
  • causes object[]
    Plain-text descriptive reasons to provide additional detail to the text provided in the messages field
  • Array [
  • ]

An example of a 500 response object