Modify a request
This endpoint retrieves all the details of a specific request including the answers of the forms and the documents that have been uploaded.
Body
-
The ID of the request you want to modify.
-
The new status of the request. Can be one of the predifined status
pending
,completed
,waiting
,canceled
,archived
or a custom status that you previously have created on your account. -
The new due date of the request. The due date should be encoded as a string using ISO 8601 format.
-
An object with custom data that you want to use in your request.
Additional properties are allowed.
-
The ID of the team member you want to assign the request to. Use 'unset' if you want to unassign the request.
-
Boolean. If set to true, a message will be automatically send when the request status will be changed to "completed". This message can be customized in the branding settings used for this campaign.
-
Boolean. If set to true, a message will be automatically send when the request status will be changed to "pending" and at least one element on the portal has been rejected. This message can be customized in the branding settings used for this campaign.
-
Boolean. If set to true, a message will be automatically send when the request status will be changed to "pending". This message can be customized in the branding settings used for this campaign.
Responses
-
List of requests of a campaigns.
-
Bad Request -- Your request is invalid.
-
Unauthorized -- Your API key is wrong.
-
Forbidden -- The object requested is hidden for administrators only.
-
Not Found -- The specified object could not be found.
-
Too Many Requests -- You're requesting too many objects! Slow down!
-
Internal Server Error -- We had a problem with our server. Try again later.
-
Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
curl \
--request PATCH 'https://api.usecollect.com/v1/request' \
--header "Content-Type: application/json" \
--data '{"status":"pending","requestId":"bbbBkrejSaJkHWwDE"}'
{
"status": "pending",
"requestId": "bbbBkrejSaJkHWwDE"
}
{
"errors": [],
"request": {
"_id": "bbbBkrejSaJkHWwDE",
"status": "pending",
"contact": {
"_id": "ngxhLDiDGEBS2jjKh",
"tag": [],
"email": "elon@example.com",
"custom": [],
"company": "Tesla",
"lastName": "Musk",
"createdAt": "2022-11-16T05:00:43Z",
"firstName": "Elon",
"lastActivity": "2022-02-21T10:31:52Z"
},
"dueDate": null,
"privacy": "private",
"branding": {
"brandingId": "bJoTr6kHikTRDsvSd",
"useBranding": true
},
"createdAt": "2023-02-21T10:31:52Z",
"portalUrl": "https://app.usecollect.com/portal/LzP5r56tpqh3gteCf/bbbBkrejSaJkHWwDE",
"campaignId": "7gDq3XyLyixkhqoHa",
"sendCompletionMessage": true
}
}