Skip to content

Guard routes: update, delete

The Guard Verbs update, delete as api.sb routes, with inputs, result, refusals and an example.

Reference for Guard, one group of Guard routes.

Guard.update

Changes the given properties of a Guard. Verb page.

Text
PATCH /{namespace}/guards/{id}

Path: id. Body, as JSON: the other inputs. Emits Guard.updated.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Guard.
tierstringOne of code, model, reviewer, or human.
checksstringWhat it refuses; a claim Guard checks a stated term or promise against the record that backs it. Never randomized.

Returns

OutputTypeRequiredDescription
guardGuardrequiredThe Guard.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X PATCH https://api.sb/leaseline.app/guards/guard_WtKo3jQi6J \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tier":"code"}'
JSON
{
  "api": "https://api.sb/leaseline.app",
  "guard": {
    "$id": "https://api.sb/leaseline.app/guards/guard_WtKo3jQi6J",
    "$type": "Guard",
    "tier": "code"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Guard.update",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}

Guard.delete

Deletes a Guard: a soft delete that keeps its history, undone by Thing.restore. Verb page.

Text
DELETE /{namespace}/guards/{id}

Path: id. Emits Guard.deleted.

Inputs

InputTypeRequiredDescription
idstringrequiredThe id of the Guard.

Returns

OutputTypeRequiredDescription
guardGuardrequiredThe Guard.

Refuses when

CheckErrorFixThen call
The key is valid, but its scopes do not allow this operation.forbiddenUse a key whose scopes cover the operation, or ask an owner of the namespace to grant them.None.

Example

Terminal
curl -X DELETE https://api.sb/leaseline.app/guards/guard_WtKo3jQi6J \
  -H "Authorization: Bearer $STARTUP_BUILDER_API_KEY"
JSON
{
  "api": "https://api.sb/leaseline.app",
  "guard": {
    "$id": "https://api.sb/leaseline.app/guards/guard_WtKo3jQi6J",
    "$type": "Guard",
    "tier": "code"
  },
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/act_br07HsG8MG",
    "operation": "Guard.delete",
    "status": "done"
  },
  "links": {
    "self": "https://api.sb/leaseline.app/actions/act_br07HsG8MG"
  }
}