Batch create/update config files

POST

///v1/config/:device_uuid/batch

POST

/v1/config/:device_uuid/batch

$ curl -X POST /v1/config/device_uuid/batch \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "files": [
>     {
>       "author": "jane.doe@example.com",
>       "commit_message": "Update network configuration for improved latency",
>       "content": "interface eth0\nip address 192.168.1.10/24\ngateway 192.168.1.1\n",
>       "filename": "network.conf"
>     }
>   ]
> }'

1 {
2   "created": [
3     {
4       "author": "jane.doe@example.com",
5       "commit_message": "Update network configuration for improved latency",
6       "content_hash": "3a7bd3e2360a3f1b9c8e4d5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b",
7       "created_at": "2024-01-15T09:30:00Z",
8       "file_type": "intended",
9       "version": 1
10     }
11   ],
12   "skipped": [
13     "backup/config_backup.conf"
14   ]
15 }

Batch create or update configuration files for a device.

Authentication

AuthorizationBearer

Bearer JWT used by CLI and machine clients on svc-* endpoints. Authentication is required by default, but deployments may disable it with [auth] required = false. Browser OIDC sessions, mTLS, SPIFFE identities, and trusted gateway identity headers may also satisfy authentication outside this generated client flow.

Path parameters

device_uuidstringRequiredformat: "uuid"

Request

This endpoint expects an object.

fileslist of objectsRequired

List of files to create/update

Response

Successful Response

createdlist of objects

Successfully created/updated files

skippedlist of strings

Paths that had no changes

Errors

422

Unprocessable Entity Error