TVR-33624 : [API] Cascading Request - API reference documentation

src/api-reference/request/v4.endpoints.participant-resources.markdown

@@ -0,0 +1,168 @@
+---
+title: Travel Request v4 - Participant Resources
+layout: reference
+---
+
+{% include prerelease.html %}
+
+# Travel Request v4 - Participant Resources
+
+Manage participants and child requests attached to a Budget Request.
+
+## <a name="get-request-participants"></a>Get Participants for a Budget Request
+
+This endpoint will enable you to retrieve the list of participants of a Budget Request, as well as the child Requests for each of the participants.
+
+### Scopes
+
+`travelrequest.write` - Refer to [Scope Usage](./v4.get-started.html#scope-usage) for full details.
+
+### HTTP Request
+
+##### URI Template
+
+```
+GET {datacenter}/travelrequest/v4/requests/{requestUuid}/participants
+```
+
+#### Parameters
+
+Name|Type|Format|Description
+---|---|---|---
+`requestUuid`|`string`|[RFC 4122]|**Required** The unique identifier of the Request.
+`userId`|`string`|-|The unique identifier of the user getting the participants list. If empty when using a Company token the default system user will be assumed to perform the action.
+
+#### Headers
+
+`concur-correlationid` is a specific custom header used for technical support in the form of a [RFC 4122 A Universally Unique IDentifier (UUID) URN Namespace](https://tools.ietf.org/html/rfc4122).
+
+#### Payload
+
+None.
+
+### HTTP Response
+
+#### HTTP Status Codes
+
+To learn more about response HTTP status codes for this API see [Travel Request v4 - HTTP Status Codes](./v4.response-codes.html).
+
+#### Payload
+
+[ParentRequestParticipant](./v4.endpoints.schemas.html#schema-parentrequestparticipant)
+
+### Example - One participant with two Child Requests and One Participant without Child Request
+
+#### HTTP Request
+
+```shell
+GET https://us.api.concursolutions.com/travelrequest/v4/requests/224AF3CDCC2A5244A37C72FA5770C6F2/participants
+Accept: application/json
+Authorization: Bearer {token}
+Concur-CorrelationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f
+```
+
+#### HTTP Response
+
+```shell
+200 OK
+```
+
+```json
+[
+  {
+    "participant": {
+      "id": "60dea1fd-489f-48b9-925f-0d62a5b48175"
+    },
+    "requests": [
+      {
+        "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4",
+        "id": "A1B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4",
+        "template": "https://us.api.concursolutions.com/travelrequest/v4/requests/{id}"
+      },
+      {
+        "href": "https://us.api.concursolutions.com/travelrequest/v4/requests/B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5",
+        "id": "B2C3D4E5F6A1B2C3D4E5F6A1B2C3D4E5",
+        "template": "https://us.api.concursolutions.com/travelrequest/v4/requests/{id}"
+      },
+    ]
+  },
+  {
+    "participant": {
+      "id": "72efb2ae-5a0e-59ca-b037-1e73b6c59286"
+    }
+  }
+]
+```
+
+## <a name="patch-request-participants"></a>Manage Participants of a Budget Request
+
+This endpoint will enable to manage participants (add or remove them) from a Budget Request.
+
+### Scopes
+
+`travelrequest.write` - Refer to [Scope Usage](./v4.get-started.html#scope-usage) for full details.
+
+### HTTP Request
+
+##### URI Template
+
+```
+PATCH {datacenter}/travelrequest/v4/requests/{requestUuid}/participants
+```
+
+#### Parameters
+
+Name|Type|Format|Description
+---|---|---|---
+`requestUuid`|`string`|[RFC 4122]|**Required** The unique identifier of the Request.
+`userId`|`string`|-|The unique identifier of the user updating the participants list. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error.
+
+#### Headers
+
+`concur-correlationid` is a specific custom header used for technical support in the form of a [RFC 4122 A Universally Unique IDentifier (UUID) URN Namespace](https://tools.ietf.org/html/rfc4122).
+
+#### Payload
+
+[Request Participants For Patch](./v4.endpoints.schemas.html#schema-requestparticipantsforpatch)
+
+### HTTP Response
+
+#### HTTP Status Codes
+
+To learn more about response HTTP status codes for this API see [Travel Request v4 - HTTP Status Codes](./v4.response-codes.html).
+
+#### Payload
+
+None.
+
+### Example - adding and removing a participant to a Budget Request
+
+#### HTTP Request
+
+```shell
+PATCH https://us.api.concursolutions.com/travelrequest/v4/requests/224AF3CDCC2A5244A37C72FA5770C6F2/participants
+Content-Type: application/merge-patch+json
+Accept: application/json
+Authorization: Bearer {token}
+Concur-CorrelationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f
+```
+
+```json
+{
+  "value": [
+    {
+      "id": "8422A66-A9B0-1424-5802-0D9BCD4351D3"
+    },
+    {
+      "id": "9C33FBA0-ACB7-4F85-83BD-FC0DF3A78522",
+      "@deleted": true
+    }
+  ]
+}
+```
+
+#### HTTP Response
+
+```shell
+204 No Content
+```

src/api-reference/request/v4.endpoints.policy-resources-new.markdown

@@ -0,0 +1,88 @@
+---
+title: Travel Request v4 - Request Policy Resources
+layout: reference
+---
+
+{% include prerelease.html %}
+
+# Travel Request v4 - Request Policy Resources
+
+## Get the list of existing Request policies for a given user <a name="get-user-request-policy-resource"></a>
+
+### Scopes
+
+`travelrequest.write` - Refer to [Scope Usage](./v4.get-started.html#scope-usage) for full details.
+
+### HTTP Request
+
+##### URI Template
+
+```
+GET {datacenter}/travelrequest/v4/userpolicies
+```
+
+#### Parameters
+
+Name|Type|Format|Description
+---|---|---|---
+`userId`|`string`|-|The unique identifier of the user for whom the list of Request policies will be retrieved. **Required** when connecting with a Company token. If empty, a 400 `missingRequiredParam` error.
+
+#### Headers
+
+`concur-correlationid` is a specific custom header used for technical support in the form of a [RFC 4122 A Universally Unique IDentifier (UUID) URN Namespace](https://tools.ietf.org/html/rfc4122).
+
+
+#### Payload
+
+None.
+
+### HTTP Response
+
+#### HTTP Status Codes
+
+To learn more about response HTTP status codes for this API see [Travel Request v4 - HTTP Status Codes](./v4.response-codes.html).
+
+#### Payload
+
+[List of Request Policies](./v4.endpoints.schemas.html#schema-requestpolicylist)
+
+### Example
+
+#### HTTP Request
+
+```shell
+GET https://us.api.concursolutions.com/travelrequest/v4/userpolicies
+Accept: application/json
+Authorization: Bearer {token}
+Concur-CorrelationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f
+```
+
+#### HTTP Response
+
+```shell
+200 OK
+```
+
+```json
+[
+  {
+   "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/F4C8BD31CA9D4D6292795BE687EB9B2A",
+   "id": "F4C8BD31CA9D4D6292795BE687EB9B2A",
+   "name": "Internal training Request policy",
+   "allowParticipants": false
+  },
+  {
+   "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/F10E6059B5A14A4C80327FE387491026",
+   "id": "F10E6059B5A14A4C80327FE387491026",
+   "name": "Client meeting Request policy",
+   "allowParticipants": false,
+  },
+  {
+   "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/98B49B2523DDAB41A182DD581C637415",
+   "id": "98B49B2523DDAB41A182DD581C637415",
+   "name": "Budget Event Request policy",
+   "allowParticipants": true
+  }
+]
+
+```

src/api-reference/request/v4.endpoints.policy-resources.markdown

@@ -63,14 +63,22 @@ Concur-CorrelationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f
 ```json
 [
   {
-    "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/F4C8BD31CA9D4D6292795BE687EB9B2A",
-    "id": "F4C8BD31CA9D4D6292795BE687EB9B2A",
-   "name": "Internal training Request policy"
+   "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/F4C8BD31CA9D4D6292795BE687EB9B2A",
+   "id": "F4C8BD31CA9D4D6292795BE687EB9B2A",
+   "name": "Internal training Request policy",
+   "allowParticipants": false
   },
   {
-    "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/F10E6059B5A14A4C80327FE387491026",
-    "id": "F10E6059B5A14A4C80327FE387491026",
-   "name": "Client meeting Request policy"
+   "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/F10E6059B5A14A4C80327FE387491026",
+   "id": "F10E6059B5A14A4C80327FE387491026",
+   "name": "Client meeting Request policy",
+   "allowParticipants": false,
+  },
+  {
+   "href": "https://us.api.concursolutions.com/travelrequest/v4/userpolicies/98B49B2523DDAB41A182DD581C637415",
+   "id": "98B49B2523DDAB41A182DD581C637415",
+   "name": "Budget Event Request policy",
+   "allowParticipants": true
   }
 ]