ACaccessowl
policies

Replace a policy's application list

Changed on

Replaces the set of applications attached to a policy. The provided list fully overwrites the policy's current applications (it is not additive).

put/api/v1/policies/{policy_id}/applications

Request

  • Base URL
    https://app.accessowl.io
  • URL
    https://app.accessowl.io/api/v1/policies/{policy_id}/applications
  • Auth
    HTTP bearer

Path parameters

policy_idstring uuid required

Headers

Idempotency-Keystring

Optional key (1–255 chars) for safely retrying a request. Reusing the same key for the same request returns 409 Conflict and is not processed again — this confirms the request was already received. Keys are retained for 14 days.

Request body

application_idsstring[] required

The complete set of application IDs for this policy.

elevatedboolean

When true, the policy applies only to elevated access requests.

Example request

{
  "application_ids": [
    "7488a646-e31f-11e4-aace-600308960670"
  ],
  "elevated": false
}

Response

Policy

application_idsstring[]

IDs of the applications this policy applies to

default_policyboolean required

Whether this is the default policy

elevatedboolean required

When true, the policy applies only to elevated access requests

idstring uuid required

Policy ID

inserted_atstring date-time
lock_versioninteger

Optimistic lock version

titlestring required

Policy title

updated_atstring date-time

Example response

{
  "application_ids": [
    "8599b757-f42a-22f5-bbdf-711419071781"
  ],
  "approval_steps": [
    {
      "approver_types": [
        "manager"
      ],
      "specific_approver_user_ids": [],
      "step": 1,
      "strategy": "first_to_respond"
    }
  ],
  "default_policy": false,
  "elevated": false,
  "id": "7488a646-e31f-11e4-aace-600308960670",
  "inserted_at": "2023-01-01T00:00:00Z",
  "lock_version": 1,
  "title": "Engineering manager approval",
  "updated_at": "2023-01-01T00:00:00Z"
}

Changes

  • 5a1f071e40d8Revision changes
    • breaking

      response property errors/additionalProperties/items/ list-of-types was widened by adding types object to media type application/json of response 422

    • breaking

      removed the required property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      added the new conflict enum value to the response property for the response status

    • warning

      added the new forbidden enum value to the response property for the response status

    • warning

      added the new idempotency_key_already_used enum value to the response property for the response status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

  • 209e132db90bRevision changes
    • info

      added the required property to the response with the status