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

Request

  • Base URL
    https://api.maia-analytics.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.maia-analytics.com/api/v1/internal/projects/{project_id}/edit-session
  • Auth
    HTTP bearer

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.

Changes

No recorded changes to this operation across all 30 revisions of this API.