Skip to main content
Previous API version. Use PATCH /forms/{id} for new integrations. This route still works but is deprecated.
Update a request’s (now form’s) status or expiration date. 
PATCH https://connect.penbox.io/v1/requests/{id}

​
Path Parameters

ParameterTypeDescription
idstring (uuid)Request identifier

​
Request Body

At least one field must be provided.
FieldTypeDescription
archivedbooleanArchive or unarchive the request
draftbooleanSet draft status (true = draft, false = activate)
processedbooleanMark as processed or unprocessed
active_untilstringUpdate expiration date (ISO 8601)

​
Example

cURL
curl -X PATCH 'https://connect.penbox.io/v1/requests/REQUEST_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "archived": true }'

​
Response

Returns the updated request object (same shape as Get Request).

​
Response Codes

CodeDescription
200Success
400Bad Request — no valid field provided
401Unauthorized
403Forbidden
404Not Found — request doesn’t exist
422Unprocessable — validation failed
429Too Many Requests
500Server Error