v4

latestOpenAPI 3.1.02026-08-08278476614.0 KB

internal

internal-projects

Start Edit Session

Begin an admin write-mode editing session on a user's project.

Acquires the project editing lock for the admin (409 if another user holds it) and records one EDIT_PROJECT_AS_ADMIN audit row. With force=true the holder is evicted instead of 409ing and the audit metadata records the takeover. The client then navigates into the project with ?admin_mode=write.

post/api/v1/internal/projects/{project_id}/edit-session

Path parameters

project_idstring uuid required

Query parameters

forceboolean

Response

Successful Response

is_lockedboolean required

Whether the project is currently locked.

locked_by_user_idstring nullable

User ID of the lock holder, if locked.

locked_by_display_namestring nullable

Display name of the lock holder for UI.

locked_by_avatar_colorstring nullable

Avatar color name of the lock holder for UI.

is_current_userboolean

True when the current user holds the lock.

ttl_secondsinteger nullable

Remaining TTL of the lock in seconds, if locked.