Features

The Okta Features API provides operations to manage self-service Early Access (EA) and Beta features in your org.

Note: Important background information for this API is available on the Feature Lifecycle Management page.

List all Features
OAuth 2.0: okta.features.read

Lists all features

Responses
200

Success

403

Forbidden

429

Too Many Requests

get/api/v1/features
Request samples 
Response samples 
application/json
[
  • {
    • "description": "string",
    • "id": "string",
    • "name": "string",
    • "stage": {
      },
    • "status": "DISABLED",
    • "type": "self-service",
    • "_links": {
      }
    }
]
Retrieve a Feature
OAuth 2.0: okta.features.read
Retrieves a feature


Request 
path Parameters
featureId
required
string
id of the Feature


 
 Example:  R5HjqNn1pEqWGy48E9jg
Responses 
200
Success


403
Forbidden


404
Not Found


429
Too Many Requests


get/api/v1/features/{featureId}
Request samples 
Response samples 
application/json
{
  • "description": "string",
  • "id": "string",
  • "name": "string",
  • "stage": {
    • "state": "CLOSED",
    • "value": "BETA"
    },
  • "status": "DISABLED",
  • "type": "self-service",
  • "_links": {
    • "self": {
      }
    }
}
List all Dependencies
OAuth 2.0: okta.features.read
Lists all dependencies


Request 
path Parameters
featureId
required
string
id of the Feature


 
 Example:  R5HjqNn1pEqWGy48E9jg
Responses 
200
Success


403
Forbidden


404
Not Found


429
Too Many Requests


get/api/v1/features/{featureId}/dependencies
Request samples 
Response samples 
application/json
[
  • {
    • "description": "string",
    • "id": "string",
    • "name": "string",
    • "stage": {
      },
    • "status": "DISABLED",
    • "type": "self-service",
    • "_links": {
      }
    }
]
List all Dependents
OAuth 2.0: okta.features.read
Lists all dependents


Request 
path Parameters
featureId
required
string
id of the Feature


 
 Example:  R5HjqNn1pEqWGy48E9jg
Responses 
200
Success


403
Forbidden


404
Not Found


429
Too Many Requests


get/api/v1/features/{featureId}/dependents
Request samples 
Response samples 
application/json
[
  • {
    • "description": "string",
    • "id": "string",
    • "name": "string",
    • "stage": {
      },
    • "status": "DISABLED",
    • "type": "self-service",
    • "_links": {
      }
    }
]
Update a Feature Lifecycle
OAuth 2.0: okta.features.manage
Updates a feature lifecycle


Request 
path Parameters
featureId
required
string
id of the Feature


 
 Example:  R5HjqNn1pEqWGy48E9jg
lifecycle
required
string (FeatureLifecycle) 
Whether to enable or disable the feature


 Enum: "disable" "enable"  
 Example:  enable
query Parameters
mode
string
 
Responses 
200
Success


403
Forbidden


404
Not Found


429
Too Many Requests


post/api/v1/features/{featureId}/{lifecycle}
Request samples 
Response samples 
application/json
{
  • "description": "string",
  • "id": "string",
  • "name": "string",
  • "stage": {
    • "state": "CLOSED",
    • "value": "BETA"
    },
  • "status": "DISABLED",
  • "type": "self-service",
  • "_links": {
    • "self": {
      }
    }
}