Convert a basic API access policy to an advanced policy

View as Markdown
POST
/resources/api_resources/{api_id}/policies/basic/{policy_id}/convert

Converts the specified basic API access policy into an advanced Cedar-authored policy in place. The policy ID is preserved, and the generated Cedar source becomes the starting point for further editing. Basic-only fields, such as clients and scopes, are discarded.

This operation is irreversible.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Path Parameters

api_id*string

The unique identifier of the API resource.

policy_id*string

The unique identifier of the basic API access policy to convert.

Response Body

200

application/json

The basic API access policy was converted successfully

TypeScript Definitions

Use the response body type in TypeScript.

Advanced API Access Policy Response: Represents a stored advanced API access policy authored using Cedar.

Errors

401Unauthorized
403Forbidden

curl -X POST "https://your-domain.us.monocloud.com/api/resources/api_resources/EF12vwe266fUHM6dh5Gup/policies/basic/GIbxRmxz2tIyQDVdGR4yE/convert" \  -H "X-API-KEY: <token>"
{  "id": "string",  "enabled": true,  "name": "string",  "description": null,  "type": "basic",  "is_permitted": true,  "cedar": "string",  "actions": {    "access_token_type": null,    "access_token_lifetime": null,    "allow_multi_audience": null,    "allow_user_info_access": null,    "bind_tokens_to_session": null  },  "creation_time": 0,  "last_updated": 0,  "revision": 0,  "error": null}
© 2026 MonoCloud. All rights reserved.