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": {
      }
    }
}