Skip to main content
DELETE
/
v1
/
bookmarks
Remove Bookmark
curl --request DELETE \
  --url https://api.thefaithapp.com/v1/bookmarks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "devotional_id": 123
}
'
import requests

url = "https://api.thefaithapp.com/v1/bookmarks"

payload = { "devotional_id": 123 }
headers = {
    "X-API-Key": "<x-api-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.delete(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'DELETE',
  headers: {
    'X-API-Key': '<x-api-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({devotional_id: 123})
};

fetch('https://api.thefaithapp.com/v1/bookmarks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.thefaithapp.com/v1/bookmarks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_POSTFIELDS => json_encode([
    'devotional_id' => 123
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "X-API-Key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.thefaithapp.com/v1/bookmarks"

	payload := strings.NewReader("{\n  \"devotional_id\": 123\n}")

	req, _ := http.NewRequest("DELETE", url, payload)

	req.Header.Add("X-API-Key", "<x-api-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.delete("https://api.thefaithapp.com/v1/bookmarks")
  .header("X-API-Key", "<x-api-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"devotional_id\": 123\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.thefaithapp.com/v1/bookmarks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["X-API-Key"] = '<x-api-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"devotional_id\": 123\n}"

response = http.request(request)
puts response.read_body
{
  "status": "<string>",
  "message": "<string>"
}
Removes a devotional from the authenticated member’s bookmarks.

Example request

{
  "devotional_id": 1
}

Request inputs

X-API-Key
string
required
Your client API key from the dashboard (Settings page).
devotional_id
number
required
Devotional ID to remove from bookmarks.

Response fields

status
string
required
Indicates whether the bookmark removal request completed successfully.
message
string
required
Confirms whether the devotional was removed now or was not previously bookmarked.

Example response

{
  "status": "Success",
  "message": "Devotional removed from bookmarks"
}