Value delete

Remove a stored blob identified by object and valueRef. Success returns 204 with no body.

DELETE
{{host}}/v1/value?object={{object}}&valueRef={{valueRef}}
VERB:DELETE
BASE URL:{{host}}/v1/value
QUERY STRING:?object={{object}}&valueRef={{valueRef}}

Query parameters#

  • objectstring
    Required

    Unique name of the object in the URL.

    format:
    abc:0-9@owner
  • valueRefstring
    Required

    Identifier returned when the blob was stored (POST).

    example: Mqn0WDHP8cuLYkMIjxAqmSdz8vRkTDDhB5Ie6Sn3

Headers#

Send these headers with the request. Names are case-insensitive per HTTP rules.
  • x-api-keyRequired

    Your BigState API key.

    *provide api key here*
  • Content-TypeRequired

    MIME type of the request body.

    application/json
  • AcceptRequired

    MIME types the client can understand in the response.

    application/json

See authentication headers here.

Response parameters#

  • 204Response body · no content

    The blob was deleted. No response body.

  • 401

    Unauthorized.

  • 403

    Access denied. The caller does not have sufficient rights to perform this operation.

  • 404

    No blob exists for this object and valueRef.

  • 400Response body · object

    Bad request.

    {

      "error": 6,

      "desc": "Invalid request"

    }
    • errornumber

      Numeric error code. See the error codes reference for the full list.

    • descstring

      Human-readable description of the error.

Examples#

Delete blob by valueRef

Remove stored bytes for this object and reference. Success: 204, no body.

curl 'https://api.bigstate.dev/v1/value?object=Z5H1QxoGRz5vc6VeNIwwpVC6biVkYTqXe9SGQJJ6%3Aposition%3Avalueref%40Z5H1QxoGRz5vc6VeNIwwpVC6biVkYTqXe9SGQJJ6&valueRef=Mqn0WDHP8cuLYkMIjxAqmSdz8vRkTDDhB5Ie6Sn3' \

  --request DELETE \

  --header 'x-api-key: YOUR_API_KEY' \

  --header 'Content-Type: application/json' \

  --header 'Accept: application/json'
MatchGet

© 2024 BigState