Credentials
Update Credential
Authorization<token>
User API key (Bearer scp_u_...). Create in Platform > API Keys.
In: header
Path Parameters
id*string
Credential ID
Format
uuidRequest Body
application/json
assigned_network_ids*array<string>
Networks this credential is assigned to (Broadcast scope).
Hydrated from the network_credentials junction table.
credential_type*||||||
Universal credential type — tagged enum stored as JSONB. Each variant represents a different credential protocol/method.
host_assignments*
Hosts this credential is assigned to (PerHost scope), with optional IP scoping.
Hydrated from the host_credentials junction table.
name*string
organization_id*string
Format
uuidtags*array<string>
target_ips?|null
Ephemeral bootstrap IPs for pre-discovery credential resolution. Cleared automatically when the next scan dispatches.
Response Body
application/json
application/json
application/json
curl -X PUT "https://loading/api/v1/credentials/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{ "assigned_network_ids": [ "497f6eca-6276-4993-bfeb-53cbbbba6f08" ], "credential_type": { "community": { "mode": "Inline", "value": "string" }, "type": "SnmpV1" }, "host_assignments": [ { "host_id": "eb4e20fc-2b4a-4d0c-811f-48abcf12b89b", "ip_address_ids": [ "497f6eca-6276-4993-bfeb-53cbbbba6f08" ] } ], "name": "string", "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6", "tags": [ "497f6eca-6276-4993-bfeb-53cbbbba6f08" ] }'{
"meta": {
"api_version": 1,
"server_version": "0.17.1"
},
"success": true,
"data": {
"assigned_network_ids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"credential_type": {
"community": {
"mode": "Inline",
"value": "string"
},
"type": "SnmpV1"
},
"host_assignments": [
{
"host_id": "eb4e20fc-2b4a-4d0c-811f-48abcf12b89b",
"ip_address_ids": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
]
}
],
"name": "string",
"organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
"tags": [
"497f6eca-6276-4993-bfeb-53cbbbba6f08"
],
"target_ips": [
"string"
],
"created_at": "2019-08-24T14:15:22Z",
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"updated_at": "2019-08-24T14:15:22Z"
},
"error": "string"
}{
"meta": {
"api_version": 1,
"server_version": "0.17.1"
},
"success": true,
"code": "string",
"error": "string",
"params": {
"property1": null,
"property2": null
}
}{
"meta": {
"api_version": 1,
"server_version": "0.17.1"
},
"success": true,
"code": "string",
"error": "string",
"params": {
"property1": null,
"property2": null
}
}