SOsocket-dev
alert-policies

Get Org Alert Policy Migration Status

Changed on

Retrieve the alert policy migration status of an organization. This is read-only and does not enroll organizations or start migration windows. Requires a token with org-wide repository access; repo-restricted tokens receive 403.

This endpoint consumes 1 unit of your quota.

This endpoint requires the following org token scopes:

  • alert-policy:list
get/orgs/{org_slug}/alert-policies/migration/status

Request

  • Base URL
    https://api.socket.dev/v0
  • URL
    https://api.socket.dev/v0/orgs/{org_slug}/alert-policies/migration/status
  • Auth
    • HTTP bearer
    • or HTTP basic

Path parameters

org_slugstring required

The slug of the organization

Response

The alert policy migration status of the organization.

state'pending' | 'previewing' | 'accepted' | 'auto_finalized' | 'rolled_back' nullable required

Current migration state. Null when the organization is not enrolled.

finalized_atstring nullable required

ISO-8601 timestamp when migration finalized.

deadline_atstring nullable required

ISO-8601 auto-finalization deadline.

window_end_atstring nullable required

ISO-8601 end of the organization migration window.

deadline_admin_paused_atstring nullable required

ISO-8601 timestamp when an administrator paused the deadline.

alert_policies_enabledboolean required

Whether the alert policy layer evaluates for this organization. True for migrated organizations and for organizations that started on Rules & Policies.

legacy_evaluation_enabledboolean required

Whether legacy alert triage and the legacy security policy still evaluate for this organization.

Changes