post
https://api.vcita.biz/platform/v1/apps//assign
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)
POST /v3/apps/app_assignments){
"assignee_type": "directory",
"assignee_uid": "def456",
"app_code_name": "myapp",
"settings": {
"assignment_mode": "internal"
}
}
Parameter Mapping
| Old Parameter | New Parameter |
|---|---|
business_uid | assignee_uid (with assignee_type: "business") |
directory_uid | assignee_uid (with assignee_type: "directory") |
is_internal: "true" | settings.assignment_mode: "internal" |
pre_installed: "true" | settings.assignment_mode: "pre_installed" |
built_in: "true" | Not supported in v3 |
