Unarchive notices
Brings archived notices back to the inbox and returns the unread count after the change.
They stay read. Ids of notices the person does not have are ignored.
Guide: Notices
AuthorizationBearer <token>
A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.
In: header
Path parameters
organizationId*string
The organization's id, org_....
Request body
application/json
TypeScript definitions
Use the request body type in TypeScript.
noticeIds*array<string>
Ids of the person's notices, notice_..., up to 200.
Items
items <= 200Examples
curl -X POST "https://api.voidhash.com/api/v1/organizations/org_w5xk2e7q0lzv3n8b1c4d6f9g/notices/unarchive" \ -H "Authorization: Bearer vh_sk_..." \ -H "Content-Type: application/json" \ -d '{ "noticeIds": [ "notice_p4r7t0y3u6i9o2a5s8d1f4g7" ] }'{ "organizationId": "org_w5xk2e7q0lzv3n8b1c4d6f9g", "count": 2}{ "error": { "type": "invalid_request", "code": "invalid_body", "message": "The request body is invalid: Missing key\n at [\"noticeIds\"]" }}{ "error": { "type": "unauthenticated", "code": "invalid_api_key", "message": "This secret key is not valid." }}{ "error": { "type": "permission_denied", "code": "permission_denied", "message": "Insufficient permissions." }}{ "error": { "type": "not_found", "code": "organization_not_found", "message": "There is no organization org_w5xk2e7q0lzv3n8b1c4d6f9g, or this credential cannot use it.", "param": "organizationId" }}{ "error": { "type": "internal", "code": "internal_error", "message": "Something went wrong on our side. Try again, and contact support with the Request-Id header if it keeps failing." }}Response body
application/json
application/json
application/json
application/json
application/json
application/json
Errors
This operation adds no error codes of its own. It can fail with the errors every operation shares, such as unauthenticated; see Errors.
More in Notices
- List notices
GET - Count unread notices
GET - Mark notices read
POST - Archive notices
POST - Retrieve notice preferences
GET - Update notice preferences
PATCH
Something wrong or missing on this page? Tell us by email or on Discord.