Update a connected app

Limits a connected app to reading, or lifts the limit.

Only the person signed in to the dashboard can.

Errors

Status	`type`	`code`	When
403	`permission_denied`	`dashboard_session_required`	For any other credential.
404	`not_found`	`connected_app_not_found`	When the app is no longer connected.

It can also fail with the errors every operation shares, such as unauthenticated; see Errors.

More in Connected apps

Something wrong or missing on this page? Tell us by email or on Discord.

On this page

Authorization Path parameters Request body Examples Response body Errors More in Connected apps

Authorization

AuthorizationBearer <token>

A project secret key: vh_sk_... for production, vh_sk_test_... for test. Keep it on your servers.

In: header

Path parameters

connectedAppId*string

The connected app's id, a UUID, as GET /me/connected-apps lists it.

Request body

application/json

TypeScript definitions

Use the request body type in TypeScript.

isReadOnly?|

true limits the app to reading; false lifts the limit.

Examples

curl -X PATCH "https://api.voidhash.com/api/v1/me/connected-apps/3f2b8c1e-7d4a-4e9b-a6c5-1d0f8e2b7a94" \  -H "Authorization: Bearer vh_sk_..." \  -H "Content-Type: application/json" \  -d '{    "isReadOnly": true  }'

{  "id": "3f2b8c1e-7d4a-4e9b-a6c5-1d0f8e2b7a94",  "kind": "cli",  "clientName": "Voidhash CLI",  "reportedName": null,  "device": "grace-mbp",  "isReadOnly": true,  "connectedAt": "2026-02-01T08:10:00.000Z",  "lastUsedAt": "2026-03-14T09:20:00.000Z",  "idleExpiresAt": "2026-06-12T09:20:00.000Z"}

{  "error": {    "type": "invalid_request",    "code": "invalid_body",    "message": "The request body is invalid: Expected object"  }}

{  "error": {    "type": "unauthenticated",    "code": "invalid_api_key",    "message": "This secret key is not valid."  }}

{  "error": {    "type": "permission_denied",    "code": "dashboard_session_required",    "message": "Only you, signed in to Voidhash, can accept the Terms of Service; an app or key acting for you cannot."  }}

{  "error": {    "type": "not_found",    "code": "connected_app_not_found",    "message": "You have no connected app 3f2b8c1e-7d4a-4e9b-a6c5-1d0f8e2b7a94; it may have been disconnected.",    "param": "connectedAppId"  }}

{  "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."  }}

Update a connected app

Errors

More in Connected apps

Update a connected app

Errors

More in Connected apps

Authorization

Path parameters

Request body

Examples

Response body

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

Update a connected app

Update a connected app

200application/json

400application/json

401application/json

403application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`