Organization을 만들었는데 사용할 수 없습니다#
새 Organization은 Structly 관리자 인증 전까지 선택하거나 Catalog를 기록할 수 없습니다.
Web UI의 인증 상태 새로고침이나 stly org list의 verification_status로 인증 여부를 확인합니다.
인증 대기 Organization으로 Catalog를 요청하면 HTTP 403 ORGANIZATION_UNVERIFIED가 반환됩니다.
비밀번호를 잊었습니다#
비밀번호 재설정 기능은 제공하지 않습니다. 로그인한 상태라면 사용자 메뉴 → 비밀번호 변경에서 새 비밀번호로 바꿀 수 있습니다.
가입 확인 메일이 오지 않습니다#
Structly는 가입 확인 메일을 보내지 않습니다. 가입하면 바로 로그인됩니다.
로그인하라는 오류가 납니다#
저장된 로그인이 없으면 stly는 요청을 보내지 않고 CLI_CONFIG 오류(종료 코드 2)로 끝납니다. stly auth login으로 로그인합니다.
401 UNAUTHENTICATED가 반환됩니다#
로그인이 만료되었거나 유효하지 않습니다. Web에서 로그인 상태 유지를 선택한 세션과 stly 로그인은 마지막 활동 후 30일에 만료됩니다. 선택하지 않은 Web 세션은 브라우저를 닫을 때 끝나며 서버에서는 마지막 활동 24시간 후 만료됩니다. 브라우저 설정에 따라 닫은 뒤에도 세션이 복원될 수 있습니다. Web UI에서 다시 로그인하거나 stly auth login을 실행합니다.
stly auth status로 stly가 사용하는 인증 정보와 서버 주소를 확인합니다.
409 ORGANIZATION_REQUIRED가 반환됩니다#
현재 Organization이 선택되지 않았습니다. stly org list로 인증된 Organization의 ID를 확인하고 stly org select <id>로 선택합니다.
오류의 hints에 실행할 명령이 들어 있습니다.
412 PRECONDITION_FAILED가 반환됩니다#
조회한 뒤 다른 변경이 먼저 저장되었습니다. 상세를 다시 조회해 최신 값과 새 etag를 확인하고 다시 수정합니다.
자세한 순서는 동시 수정 충돌을 참고합니다.
--if-match가 필요하다는 오류가 납니다#
수정·삭제에는 상세 조회의 etag가 필요합니다. 값은 따옴표까지 포함하므로 --if-match '"…"'처럼 작은따옴표로 감싸 전달합니다.
Web UI와 stly의 현재 Organization이 다릅니다#
Web UI와 stly는 현재 Organization을 따로 기억합니다. 각각에서 원하는 Organization을 선택합니다.
STRUCTLY_AGENT_TOKEN이 설정되어 있으면 stly는 토큰의 Organization을 사용합니다.
stly org list가 토큰 때문에 실패합니다#
User 전용 명령은 STRUCTLY_AGENT_TOKEN이 설정된 환경에서 실행하지 않습니다. 토큰을 해제하거나 --auth-mode user를 붙입니다.
stly가 다른 서버에 요청합니다#
stly는 --server 옵션, 환경변수 STRUCTLY_API_URL, 실행 디렉터리의 .env.local 순서로 서버 주소를 정하며 모두 없으면 https://api.structly.io를 사용합니다.
stly auth status의 origin에서 실제 서버 주소를 확인합니다.
실행 결과가 outcome: unknown입니다#
timeout이나 연결 오류로 쓰기 결과를 확인하지 못했습니다. 요청이 반영되었을 수도 있으므로 같은 항목을 조회해 현재 상태를 확인한 뒤 필요할 때만 다시 실행합니다.