API

Appearance

프로젝트

검색 Default ​

POST/workspaces/{id}/projects.searchCopied!

워크스페이스 안에서 접근 가능한 프로젝트를 검색해요.

접근 가능한 사용자

사용자

접근 권한

워크스페이스
워크스페이스 소유자워크스페이스 관리자워크스페이스 멤버워크스페이스 제한된 멤버

Request ​

Body ​

keywordstring | undefined
검색어

Example: 리브랜딩

orderstringrequired
프로젝트 정렬 방식

Possible values: CREATION_DATE_ASCCREATION_DATE_DESCNAME_ASCNAME_DESCDEADLINE_ASCDEADLINE_DESCRECENTLY_VIEWED_ASCRECENTLY_VIEWED_DESC

Example: CREATION_DATE_DESC

Path ​

idstringrequired
워크스페이스 ID

Response ​

Returns 200 OK.

[]array
프로젝트 검색 결과
[].idstring
프로젝트 ID

Example: 123e4567-e89b-12d3-a456-426614174000

[].namestring
프로젝트 이름

Example: 리브랜딩 캠페인

[].descriptionstring?
프로젝트 설명
[].thumbnailstring?
프로젝트 썸네일 이미지 경로
[].deadlinestring
프로젝트 마감일

Example: 2026-05-31

[].accessRangestring
프로젝트 접근 범위

Possible values: ONLY_PROJECT_MEMBERALLOW_WORKSPACE_MEMBER

Example: ALLOW_WORKSPACE_MEMBER

[].createdAtstring
프로젝트 생성 시각

Example: 2026-04-26 09:15:00.000000

[].destroyedAtstring?
삭제 예정 시각
[].meobject
내 프로젝트 멤버 정보
[].me.idstring?
내 프로젝트 멤버 ID
[].me.rolestring?
내 프로젝트 역할

Possible values: PROJECT_OWNERPROJECT_MANAGERPROJECT_MEMBERPROJECT_REVIEWERPROJECT_RESTRICTED_REVIEWER

Example ​

bash
curl -X POST 'https://api.youvico.com/workspaces/6ba7b810-9dad-11d1-80b4-00c04fd430c8/projects.search' \
  -H 'Authorization: Bearer xoau.aB3xK9p2QwR7sT4uV1nM8oP5qL6rN0yZ7eF2gH4jK...' \
  -H 'Content-Type: application/json' \
  -d '{
    "keyword": "리브랜딩",
    "order": "CREATION_DATE_DESC"
  }'
json
[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "리브랜딩 캠페인",
    "description": "상반기 리브랜딩 작업",
    "thumbnail": null,
    "deadline": "2026-05-31",
    "accessRange": "ALLOW_WORKSPACE_MEMBER",
    "createdAt": "2026-04-26 09:15:00.000000",
    "destroyedAt": null,
    "me": {
      "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
      "role": "PROJECT_MANAGER"
    }
  }
]