Create permission boundary

POST/boundaries

Create a permission boundary in the caller's organization. target_type is USER, SERVICE_USER, GROUP or ROLE; a USER must be a member of the organization and any other target must belong to it. A target has at most one boundary per organization (409).

Headers

Authorizationstring

Bearer <token>.

Body parameters

Boundary

created_atoptional string

created_by_user_idoptional string

descriptionoptional string

display_nameoptional string

idoptional string

nameoptional string

organization_idoptional string

policy_documentoptional array of integer

target_idoptional string

target_typeoptional string

updated_atoptional string

Returns

201CreatedPermissionBoundary

created_atoptional string

created_by_user_idoptional string

descriptionoptional string

display_nameoptional string

idoptional string

nameoptional string

organization_idoptional string

policy_documentoptional array of integer

target_idoptional string

target_typeoptional string

updated_atoptional string

Errors

400Bad Request
409Conflict

curl --request POST \ --url 'https://api.hexelstudio.com/v1/boundaries' \ --header "Authorization: Bearer $ACCESS_TOKEN" \ --header 'Content-Type: application/json' \ --data '{ "created_at": "2026-01-01T00:00:00Z", "created_by_user_id": "string", "description": "string", "display_name": "string", "id": "string", "name": "string", "organization_id": "string", "policy_document": [ 0 ], "target_id": "string", "target_type": "string", "updated_at": "2026-01-01T00:00:00Z" }'

const res = await fetch("https://api.hexelstudio.com/v1/boundaries", { method: "POST", headers: { Authorization: `Bearer ${process.env.ACCESS_TOKEN}`, "Content-Type": "application/json", }, body: JSON.stringify({ "created_at": "2026-01-01T00:00:00Z", "created_by_user_id": "string", "description": "string", "display_name": "string", "id": "string", "name": "string", "organization_id": "string", "policy_document": [ 0 ], "target_id": "string", "target_type": "string", "updated_at": "2026-01-01T00:00:00Z" }), }) const data = await res.json()

import os import requests res = requests.post( "https://api.hexelstudio.com/v1/boundaries", headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"}, json={ "created_at": "2026-01-01T00:00:00Z", "created_by_user_id": "string", "description": "string", "display_name": "string", "id": "string", "name": "string", "organization_id": "string", "policy_document": [ 0, ], "target_id": "string", "target_type": "string", "updated_at": "2026-01-01T00:00:00Z", }, ) data = res.json()

{ "created_at": "2026-01-01T00:00:00Z", "created_by_user_id": "string", "description": "string", "display_name": "string", "id": "string", "name": "string", "organization_id": "string", "policy_document": [ 0 ], "target_id": "string", "target_type": "string", "updated_at": "2026-01-01T00:00:00Z" }