Profiles API doc: Add additional examples. Add index link

Author: abdulazizali77

restcomm/restcomm.docs/sources-asciidoc/src/main/asciidoc/api/index.adoc

@@ -34,6 +34,7 @@ Restcomm Accounts have the following subresources. Click on a link to read the A
 * <<ussd-push-api.adoc#uss-push,Restcomm API – UssdPush>>
 * <<conferences-api.adoc#conferenceapi, Restcomm API - Conference Management>>
 * <<participants-api.adoc#participantsapi, Restcomm API - Conference Participants Management>>
+* <<profile-api.adoc#profileapi, Restcomm API - Profiles Management>>
 
 === Management Sub-Resources
 

restcomm/restcomm.docs/sources-asciidoc/src/main/asciidoc/api/profile-api.adoc

@@ -123,15 +123,19 @@ To associate a single Profile with multiple Accounts/Organizations, multiple req
 ....
 curl -X GET  https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2acf
 ....
+**Add a new Profile.**
 
+....
+curl -X POST -H 'Content-Type: application/instance+json' --data "@/path/to/filename" https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles
+....
 
 **Modify a Profile.**
 
-To update a Profile you need to provide the SID
+To update a Profile you need to provide the Profile SID
 
 For example, update Proile using sid:
 ....
-curl -H 'Content-Type: application/instance+json' --data "@/path/to/filename" -X PUT https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2123
+curl -X PUT -H 'Content-Type: application/instance+json' --data "@/path/to/filename" https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2123
 ....
 
 ....
@@ -163,6 +167,32 @@ The above command will print an output similar to the one below:
 }
 ----
 
+**Link/Unlink a Profile to an Entity**
+
+To link a Profile to an Account
+
+....
+curl -X PUT -H "X-HTTP-Method-Override:LINK" -H "Link:<https://127.0.0.1:8080/restcomm/2012-04-24/Accounts/ACae6e420f425248d6a26948c17a9e2acf>;rel=related" https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2123
+....
+
+To unlink a Profile from an Account
+
+....
+curl -X PUT -H "X-HTTP-Method-Override:UNLINK" -H "Link:<https://127.0.0.1:8080/restcomm/2012-04-24/Accounts/ACae6e420f425248d6a26948c17a9e2acf>;rel=related" https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2123
+....
+
+To link a Profile to an Organization
+
+....
+curl -X PUT -H "X-HTTP-Method-Override:LINK" -H "Link:<https://127.0.0.1:8080/restcomm/2012-04-24/Organizations/ORafbe225ad37541eba518a74248f0ac4c>;rel=related" https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2123
+....
+
+To unlink a Profile from an Organization
+
+....
+curl -X PUT -H "X-HTTP-Method-Override:UNLINK" -H  "Link:<https://127.0.0.1:8080/restcomm/2012-04-24/Organizations/ORafbe225ad37541eba518a74248f0ac4c>;rel=related" https://ACae6e420f425248d6a26948c17a9e2acf:77f8c12cc7b8f8423e5c38b035249166@127.0.0.1:8080/restcomm/2012-04-24/Profiles/PRae6e420f425248d6a26948c17a9e2123
+....
+
 [[Profiles_List]]
 == Profile List Resource