Skip to content

/v2/blueprints/{blueprint_id}/
Stable

Request

Deletes a Blueprint by its ID.

Permanently removes the specified Blueprint V2 (the current Blueprints API) instance; returns a 204 on success or a 404 if the blueprint isn't found.

About Blueprints

Blueprints define the configuration state (apps, settings, files, Wi-Fi networks, etc.) that Esper applies to devices or groups. This is the current Blueprints API (V2) — distinct from the deprecated Blueprint V1 endpoints, which point back to this API as their replacement.

Key Fields / Query Parameters

  • blueprint_id — UUID of the blueprint to delete, passed in the path

Common Use Cases

  • Removing an obsolete or unused blueprint configuration
  • Cleaning up blueprints after consolidating device policies

Best Practices

  • Confirm no active device groups still reference the blueprint before deleting it, since deletion is permanent
Path
blueprint_idstring, (uuid)required
cURL
curl -i -X DELETE \
  'https://api.esper.io/_mock/openapi/v2/blueprints/{blueprint_id}/'

Responses

Success

Bodyapplication/json
contentobject(blueprints_BlueprintV2)
messagestring
codestring
Value:201
Response
{
  "content": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "name": "string",
    "description": "string",
    "comments": "string",
    "version_number": 0,
    "version_id": "9e94c502-ca41-4342-a7f7-af96b444512c",
    "minor_version_number": 0,
    "publish": true,
    "settings": { … },
    "created_by": "string",
    "updated_by": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z"
  },
  "message": "string",
  "code": 201
}