API 레퍼런스

Projects API

조직 안에 프로젝트를 생성하고 관리 API로 조회하는 방법입니다.

POST /api/v1/projects

관리 API 키의 admin:write가 필요합니다.

plaintext

POST /api/v1/projects HTTP/1.1
Host: crm.theseeker.io
Authorization: Bearer <keyId>.<secret>
Content-Type: application/json

{"slug":"payments","name":"Payments"}

요청 필드

필드	타입	설명
`slug`	string	조직에서 유일한 API 식별자
`name`	string	표시 이름

성공 시 201과 project 객체를 반환합니다.

json

{"project":{"id":"project-id","slug":"payments","name":"Payments","createdAt":"2026-01-01T00:00:00.000Z"}}

오류

잘못된 body는 400 VALIDATION_ERROR, 같은 slug는 409 SLUG_TAKEN입니다. 인증이 없으면 401 UNAUTHORIZED, 쓰기 scope가 없으면 403 FORBIDDEN_SCOPE입니다.

프로젝트와 하위 리소스

모니터, 피드백, 서버는 프로젝트에 연결됩니다. 프로젝트 slug를 query나 body에 넣을 때는 현재 키의 범위를 확인하세요. 프로젝트 키는 자신이 발급된 프로젝트만 대상으로 합니다.

이 페이지가 도움이 되었나요?