Replace URIs, tags, and fill username. No secret.

PATCH/v1/items/{name}

Authorization

AuthorizationBearer token (JWT) · headerrequired

Hydra JWT. Identity is the bound agent or a Keto member human. The host is not identity.

Path parameters

namestringrequired

Request body

requiredapplication/json

uristring

Add this autofill host. Does not drop existing hosts.

urisstring[]

Replace autofill hosts with this list.

tagsstring[]

loginstring

Fill username. Metadata on the item. Also sealed in the envelope.

secretstring

Rotate the sealed secret — a changed password. TOTP seed, login, and passkey survive. Blank refuses; absent leaves the secret alone.

Responses

200Item metadata

idstringrequired

org_idstringrequired

namestringrequired

kindstringrequired

Allowed:api_keyoauthsshfilepasskeycardidentity

ownerOwnerrequired

Show properties

kindstringrequired

idstringrequired

urisstring[]required

tagsstring[]

archivedboolean

has_totpboolean

has_fileboolean

loginstring

Fill username. Metadata. Not a secret. Empty if unset.

400bad request

401missing or invalid Bearer

403agent cannot update items

Request

curl -X PATCH "https://veil.nyc/v1/items/string" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "uri": "string",
  "uris": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "login": "string",
  "secret": "string"
}'

const response = await fetch("https://veil.nyc/v1/items/string", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "uri": "string",
  "uris": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "login": "string",
  "secret": "string"
})
});

import requests

response = requests.patch(
    "https://veil.nyc/v1/items/string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "uri": "string",
  "uris": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "login": "string",
  "secret": "string"
},
)

Response

{
  "id": "string",
  "org_id": "string",
  "name": "string",
  "kind": "api_key",
  "owner": {
    "kind": "string",
    "id": "string"
  },
  "uris": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "archived": true,
  "has_totp": true,
  "has_file": true,
  "login": "string"
}