Revoke A Share
DELETE
/shares/grants/{grantId}
const url = 'https://app.metakip.com/api/v1/shares/grants/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request DELETE \ --url https://app.metakip.com/api/v1/shares/grants/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'Authorization: Bearer <token>'Removes a direct share. A recipient may also remove their own access.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”grantId
required
string format: uuid
The UUID of the grant.
Responses
Section titled “Responses”Share removed.
Media typeapplication/json
object
ok
required
boolean
message
required
string
Example
{ "ok": true}The API token is missing a required scope: pages:write.
Media typeapplication/json
Structured error returned when the request cannot be completed.
object
error
required
Error details for programmatic handling.
object
code
required
Stable error code.
string
message
required
Human-readable explanation.
string
Examplegenerated
{ "error": { "code": "example", "message": "example" }}