Records
Record follow
- cURL
- JSON
Request
curl -X PUT https://api.tapeapp.com/v1/record/app/unfollow-all/1 \
-H "Authorization: Bearer $TAPE_TOKEN" \
-H "Content-Type: application/json" \
--data '{}'
Request
{}
Response
{
"total_unfollowed_count": 6
}
Use this endpoint to stop notifications about the records of a database app for everyone who follows them.
Users who follow a record get notified about its updates.
In the Podio API, a follow is a subscription.
Unfollow all records in a database app
Use this endpoint to remove every follower from every record of a database app.
PUT
/v1/record/app/unfollow-all/{app_id}api.tapeapp.com- cURL
- JSON
Request
curl -X PUT https://api.tapeapp.com/v1/record/app/unfollow-all/1 \
-H "Authorization: Bearer $TAPE_TOKEN" \
-H "Content-Type: application/json" \
--data '{}'
Request
{}
Response
{
"total_unfollowed_count": 6
}
The example unfollows all records of the database app with ID 1. To find your app ID, see Find the app ID and field IDs.
General behavior
- The request unfollows all users of your organization, not only you.
- The request blocks until Tape has removed all follows. On large databases, this takes a while.
- If nobody follows a record of the database,
total_unfollowed_countis0.
Requirements: records:edit, and Full access to the app. Works with a personal access token, an OAuth access token, a user API key or an automation API key.
Errors
- A request without Full access to the app returns
400withapp_no_permission. - A request without a credential returns
401. - A token without
records:editreturns403. - A token whose content access doesn't include the app returns
404.
See Errors for all error codes.
Response fields
total_unfollowed_countinteger
Number of follows that were removed.
| Property | Type | Description |
|---|---|---|
total_unfollowed_count | integer | Number of follows that were removed. |