Skip to main content

​
Endpoint

POST /v1/profiles/{profileId}/folders

​
Request

curl -X POST "http://client-omni-api.argosidentity.com/v1/profiles/{profileId}/folders" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Supporting Documents"
  }'

​
Request Body

​
name
string
required
Display name for the folder

​
Response

{
  "success": true,
  "data": {
    "id": "fld_xyz789",
    "name": "Supporting Documents",
    "profileId": "prf_abc123def456",
    "isDefault": false,
    "createdAt": "2026-03-15T10:30:00Z"
  }
}
Each profile starts with a default folder. Additional folders can be created to organize different document types (e.g., “ID Documents”, “Financial Records”).