Skip to content
Okta Privileged Access
/
/
List secret move destinat...

List secret move destination folders

Request

OPA roles:
  • end_user

Lists the folders available as move destinations for the current user. Only folders where the user has list or secret_create permission are returned.

Note: If a folder requires unmet conditions such as MFA or access requests, an HTTP 403 error is returned and the response body includes the required access methods.

Security
bearerAuth
Path
team_namestringrequired

The name of your team

Query
parent_folder_idstring, (uuid)

The UUID of the parent folder. Specify this ID to retrieve only its direct child folders. If omitted, the API returns all top-level folders accessible by your team.

offsetstring

The offset value for pagination. The rel="next" and rel="prev" Link headers define the offset for subsequent or previous pages.

countinteger, (int32)

The number of objects per page

GET
/v1/teams/{team_name}/secrets/move-destinations
curl -i -X GET \
  'https://{org_name}.pam.okta.com/v1/teams/{team_name}/secrets/move-destinations?parent_folder_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&offset=string&count=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

OK

Bodyapplication/json
listArray of objects(MoveDestination)required

List of folders available as move destinations for the current user

Response
{
  "list": [
    { … }
  ]
}