Delete an Item

DELETE

/vaults/{vaultUuid}/items/{itemUuid}

const url = 'http://1password.local/vaults/example/items/example';
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 http://1password.local/vaults/example/items/example \
  --header 'Authorization: Bearer <token>'

Authorizations

ConnectToken

Parameters

Path Parameters

vaultUuid

required

string

/^[\da-z]{26}$/

The UUID of the Vault the item is in

itemUuid

required

string

/^[\da-z]{26}$/

The UUID of the Item to update

Responses

204

Successfully deleted an item

401

Invalid or missing token

application/json

object

message

A message detailing the error

string

status

HTTP Status Code

integer

Example

{
  "message": "Invalid token signature",
  "status": 401
}

403

Unauthorized access

application/json

object

message

A message detailing the error

string

status

HTTP Status Code

integer

Example

{
  "message": "vault {vaultUuid} is not in scope",
  "status": 403
}

404

Item not found

application/json

object

message

A message detailing the error

string

status

HTTP Status Code

integer

Examples

vaultNotFound

Vault not found

{
  "message": "vault {vaultUuid} not found",
  "status": 404
}