Create policy
curl --request POST \
--url http://127.0.0.1:8765/v1/policies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "guard.py",
"source": "def pre_command(ctx):\n if ctx[\"command\"] == \"rm\":\n return {\"kind\": \"deny\", \"reason\": \"Deletes are disabled\"}\n"
}
'import requests
url = "http://127.0.0.1:8765/v1/policies"
payload = {
"name": "guard.py",
"source": "def pre_command(ctx):
if ctx[\"command\"] == \"rm\":
return {\"kind\": \"deny\", \"reason\": \"Deletes are disabled\"}
"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'guard.py',
source: 'def pre_command(ctx):\n if ctx["command"] == "rm":\n return {"kind": "deny", "reason": "Deletes are disabled"}\n'
})
};
fetch('http://127.0.0.1:8765/v1/policies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"name": "guard.py",
"source": "def pre_command(ctx):\n if ctx[\"command\"] == \"rm\":\n return {\"kind\": \"deny\", \"reason\": \"Deletes are disabled\"}\n"
}Policies
Create policy
POST
/
v1
/
policies
Create policy
curl --request POST \
--url http://127.0.0.1:8765/v1/policies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "guard.py",
"source": "def pre_command(ctx):\n if ctx[\"command\"] == \"rm\":\n return {\"kind\": \"deny\", \"reason\": \"Deletes are disabled\"}\n"
}
'import requests
url = "http://127.0.0.1:8765/v1/policies"
payload = {
"name": "guard.py",
"source": "def pre_command(ctx):
if ctx[\"command\"] == \"rm\":
return {\"kind\": \"deny\", \"reason\": \"Deletes are disabled\"}
"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'guard.py',
source: 'def pre_command(ctx):\n if ctx["command"] == "rm":\n return {"kind": "deny", "reason": "Deletes are disabled"}\n'
})
};
fetch('http://127.0.0.1:8765/v1/policies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"name": "guard.py",
"source": "def pre_command(ctx):\n if ctx[\"command\"] == \"rm\":\n return {\"kind\": \"deny\", \"reason\": \"Deletes are disabled\"}\n"
}Save a named Python policy program. Returns
See error examples and recovery steps. The complete OpenAPI contract includes every response schema.
409 if the name already exists.
Errors
Errors
| Status | Meaning |
|---|---|
400 | The request is malformed: the body is not JSON (invalid_json) or not a JSON object, a field is missing (missing_field), unknown (unknown_field) or has a wrong value (invalid_value), or the request is otherwise invalid (invalid_request). param names the field at fault. |
401 | The token is missing or wrong (unauthorized). |
409 | The request conflicts with the current state. The id or name is taken (already_exists), the workspace is busy on another server or starting or stopping (workspace_busy), the workspace is stopped (workspace_stopped), a file changed since it was read (stale_write), or the state allows no such change (conflict). |
429 | Past a rate limit (rate_limited), or a new session past max_sessions (session_limit). |
501 | The server does not support this call (not_supported). Saved configs are kept only on a server of one account. |
Authorizations
Body
application/json