Overview

Assign an application to a business or directory so it appears in the App Market.

⚠️ DEPRECATED: Use POST /v3/apps/app_assignments instead.

Authentication

Available for Internal Tokens and Directory Tokens.

Directory Token Requirements

Directory tokens can only assign apps they own/created:

• Assign to Directory: Requires is_internal: "true". The app must be owned by your directory.
• Assign to Business: Requires hide_from_market: "true". The app must be owned by your directory and the business must belong to your directory.

Path Parameter

The {id} in the path must be the app_code_name (string identifier), not the numeric app_id.

Migration Guide

Old Format (This Endpoint)

{
  "directory_uid": "def456",
  "is_internal": "true"
}

New Format (POST /v3/apps/app_assignments)

{
  "assignee_type": "directory",
  "assignee_uid": "def456",
  "app_code_name": "myapp",
  "settings": {
    "assignment_mode": "internal"
  }
}

Parameter Mapping