GraphQL API Reference

query Me {
    me {
        userId
        email
        name
        profileImageUrl
        workspaces {
            workspaceId
        }
    }
}

query Experience {
    experience(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        experienceId: 1
    ) {
        experienceId
        tags
        title
        project {
            projectId
            name
            summary
            period {
                startAt
                endAt
            }
            role
            experienceCount
        }
        contents {
            type
            star {
                situation
                task
                action
                result
            }
            free {
                content
            }
        }
    }
}

query Experiences {
    experiences(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        projectId: 1
        jdId: "00000000-0000-0000-0000-000000000003"
        cursor: null
        size: 10
    ) {
        experiences {
            experienceId
            tags
            title
            matchRate
            recommendedReason
            project {
                projectId
                name
            }
            contents {
                type
                star {
                    situation
                    task
                    action
                    result
                }
                free {
                    content
                }
            }
        }
        cursor {
            nextCursor
            hasNext
        }
    }
}

query SearchExperiences {
    searchExperiences(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        keyword: "GraphQL"
        cursor: null
        size: 10
    ) {
        experiences {
            experienceId
            tags
            title
            project {
                projectId
                name
            }
            contents {
                type
                star {
                    situation
                    task
                    action
                    result
                }
                free {
                    content
                }
            }
        }
        cursor {
            nextCursor
            hasNext
        }
    }
}

mutation CreateExperience {
    createExperience(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        request: {
            projectId: 1
            tags: ["GraphQL", "Kotlin", "API"]
            title: "이력서 생성 API 구현"
            contents: {
                type: STAR
                star: {
                    situation: "이력서 섹션과 아이템을 자유롭게 구성해야 하는 요구사항이 있었습니다."
                    task: "클라이언트가 한 번의 요청으로 전체 이력서 스냅샷을 저장할 수 있는 API가 필요했습니다."
                    action: "SaveResumeInput을 기준으로 섹션 타입과 payload를 검증하고, core 서비스에서 저장 흐름을 일관되게 처리했습니다."
                    result: "생성, 수정 API의 입력 구조를 통일해 프론트엔드 연동 비용을 줄이고 테스트 커버리지를 확보했습니다."
                }
            }
        }
    ) {
        experienceId
        tags
        title
        project {
            projectId
            name
        }
        contents {
            type
            star {
                situation
                task
                action
                result
            }
            free {
                content
            }
        }
    }
}

mutation UpdateExperience {
    updateExperience(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        experienceId: 1
        request: {
            projectId: 1
            tags: ["GraphQL", "Spring Boot"]
            title: "이력서 GraphQL API 개선"
            contents: {
                type: STAR
                star: {
                    situation: "이력서 섹션과 아이템을 자유롭게 구성해야 하는 요구사항이 있었습니다."
                    task: "클라이언트가 한 번의 요청으로 전체 이력서 스냅샷을 저장할 수 있는 API가 필요했습니다."
                    action: "SaveResumeInput을 기준으로 섹션 타입과 payload를 검증하고, core 서비스에서 저장 흐름을 일관되게 처리했습니다."
                    result: "생성, 수정 API의 입력 구조를 통일해 프론트엔드 연동 비용을 줄이고 테스트 커버리지를 확보했습니다."
                }
            }
        }
    ) {
        experienceId
        tags
        title
        project {
            projectId
            name
        }
        contents {
            type
            star {
                situation
                task
                action
                result
            }
            free {
                content
            }
        }
    }
}

mutation DeleteExperience {
    deleteExperience(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        experienceId: 1
    )
}

query ExperienceProject {
    experienceProject(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        projectId: 1
    ) {
        projectId
        name
        summary
        period {
            startAt
            endAt
        }
        role
        experienceCount
    }
}

query ExperienceProjects {
    experienceProjects(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        cursor: null
        size: 10
    ) {
        projects {
            projectId
            name
            summary
            period {
                startAt
                endAt
            }
            role
            experienceCount
        }
        cursor {
            nextCursor
            hasNext
        }
    }
}

mutation CreateExperienceProject {
    createExperienceProject(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        input: {
            name: "잡도리 이력서 서비스"
            summary: "사용자가 이력서와 경험을 구조화해 관리할 수 있는 채용 플랫폼 기능"
            period: { startAt: "2025-01-01", endAt: "2025-06-30" }
            role: "Backend Developer"
        }
    ) {
        projectId
        name
        summary
        period {
            startAt
            endAt
        }
        role
        experienceCount
    }
}

mutation UpdateExperienceProject {
    updateExperienceProject(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        projectId: 1
        request: {
            name: "잡도리 이력서 플랫폼 고도화"
            summary: "이력서 작성, 경험 정리, GraphQL API를 개선한 프로젝트"
            period: { startAt: "2025-01-01", endAt: "2025-07-31" }
            role: "Backend Developer"
        }
    ) {
        projectId
        name
        summary
        period {
            startAt
            endAt
        }
        role
        experienceCount
    }
}

mutation DeleteExperienceProject {
    deleteExperienceProject(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        projectId: 1
    )
}

mutation ConnectNotion {
    connectNotion(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        request: {
            authorizationCode: "notion-oauth-authorization-code"
            redirectUri: "http://localhost:3000/notion/callback"
        }
    ) {
        connectionId
        notionWorkspaceName
        notionWorkspaceIcon
    }
}

mutation DisconnectNotion {
    disconnectNotion(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        connectionId: 740000000000000001
    )
}

query NotionConnections {
    notionConnections(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        cursor: null
        size: 10
    ) {
        connections {
            connectionId
            notionWorkspaceName
            notionWorkspaceIcon
        }
        cursor {
            nextCursor
            hasNext
        }
    }
}

query NotionPages {
    notionPages(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        connectionId: 740000000000000001
        query: "이력서"
        cursor: null
        size: 10
    ) {
        pages {
            pageId
            title
            url
            lastEditedTime
        }
        cursor {
            nextCursor
            hasNext
        }
    }
}

mutation ImportNotionExperiences {
    importNotionExperiences(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        request: {
            connectionId: 740000000000000001
            pageId: "notion-page-id"
        }
    )
}

query Resumes {
    resumes(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        statuses: [COMPLETED, DRAFT]
    ) {
        resumes {
            resumeId
            targetJd {
                jdId
                sourceUrl
                companyName
                positionTitle
                insight {
                    strategy
                }
                status
            }
            template
            status
            createdAt
        }
        cursor {
            nextCursor
            hasNext
        }
    }
}

query ResumeCounts {
    resumeCounts(
        workspaceId: "00000000-0000-0000-0000-000000000002"
    ) {
        status
        count
    }
}

query Resume {
    resume(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        resumeId: 94123123213123123
    ) {
        resumeId
        targetJd {
            jdId
            sourceUrl
            companyName
            positionTitle
            companyIntro
            responsibilities
            requiredExperiences
            preferredExperiences
            hiringProcess
            coreCompetencies
            insight {
                strategy
            }
            status
            createdAt
        }
        template
        status
        createdAt
        sections {
            sectionId
            type
            displayText
            displayOrder
            visible
            createdAt
            items {
                itemId
                displayOrder
                visible
                createdAt
                payload {
                    basicInfo {
                        name
                        email
                        phone
                        hideContact
                    }
                    coreSkill {
                        content
                    }
                    career {
                        companyName
                        role
                        period {
                            startAt
                            endAt
                        }
                        contents
                    }
                    experience {
                        name
                        role
                        period {
                            startAt
                            endAt
                        }
                        contents
                    }
                    education {
                        schoolName
                        major
                        degree
                        status
                        period {
                            startAt
                            endAt
                        }
                    }
                    award {
                        name
                        organization
                        awardedAt
                    }
                    language {
                        examName
                        scoreOrGrade
                        acquiredAt
                    }
                    certificate {
                        name
                        organization
                        acquiredAt
                    }
                    skill {
                        name
                        level
                    }
                }
            }
        }
    }
}

mutation CreateResumeWithDefaultItems {
    createResume(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        input: {
            targetJdId: "00000000-0000-0000-0000-00000000000a"
            template: DEFAULT
            status: DRAFT
            optimizationMode: JOB_SPECIFIC
            sections: [
                {
                    type: BASIC_INFO
                    displayOrder: 10.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: CORE_SKILL
                    displayOrder: 20.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: EXPERIENCE
                    displayOrder: 30.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                experience: {
                                    name: "이력서 관리 GraphQL API 개발"
                                    role: "Backend Developer"
                                    period: { startAt: "2025-01-01", endAt: "2025-06-30" }
                                    contents: "이력서 생성, 조회, 수정, 삭제 GraphQL API 설계 및 구현"
                                }
                            }
                        }
                    ]
                }
                {
                    type: CAREER
                    displayOrder: 40.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: EDUCATION
                    displayOrder: 60.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: AWARD
                    displayOrder: 70.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: LANGUAGE
                    displayOrder: 80.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: CERTIFICATE
                    displayOrder: 90.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
                {
                    type: SKILL
                    displayOrder: 100.0
                    visible: true
                    items: []
                    useDefaultItems: true
                }
            ]
        }
    ) {
        resumeId
        targetJd {
            jdId
            sourceUrl
            companyName
            positionTitle
            companyIntro
            responsibilities
            requiredExperiences
            preferredExperiences
            hiringProcess
            coreCompetencies
            status
            createdAt
        }
        template
        status
        createdAt
        sections {
            sectionId
            type
            displayText
            displayOrder
            visible
            items {
                itemId
                displayOrder
                visible
                payload {
                    basicInfo {
                        name
                        email
                        phone
                        hideContact
                    }
                    coreSkill {
                        content
                    }
                    experience {
                        name
                        role
                        period {
                            startAt
                            endAt
                        }
                        contents
                    }
                    career {
                        companyName
                        role
                        period {
                            startAt
                            endAt
                        }
                        contents
                    }
                    education {
                        schoolName
                        major
                        degree
                        status
                        period {
                            startAt
                            endAt
                        }
                    }
                    award {
                        name
                        organization
                        awardedAt
                    }
                    language {
                        examName
                        scoreOrGrade
                        acquiredAt
                    }
                    certificate {
                        name
                        organization
                        acquiredAt
                    }
                    skill {
                        name
                        level
                    }
                }
            }
        }
    }
}

mutation UpdateResume {
    updateResume(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        resumeId: 94123123213123123
        input: {
            targetJdId: "00000000-0000-0000-0000-00000000000a"
            template: DEFAULT
            status: COMPLETED
            optimizationMode: JOB_SPECIFIC
            sections: [
                {
                    type: BASIC_INFO
                    displayOrder: 1.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                basicInfo: {
                                    name: "잡도리"
                                    email: "jobdori.backend@example.com"
                                    phone: "010-1234-5678"
                                    hideContact: false
                                }
                            }
                        }
                    ]
                }
                {
                    type: CORE_SKILL
                    displayOrder: 2.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                coreSkill: {
                                    content: "Kotlin, Spring Boot, PostgreSQL 기반 백엔드 개발과 GraphQL API 설계에 강점이 있습니다."
                                }
                            }
                        }
                    ]
                }
                {
                    type: EXPERIENCE
                    displayOrder: 3.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                experience: {
                                    name: "이력서 관리 GraphQL API 개발"
                                    role: "Backend Developer"
                                    period: { startAt: "2025-01-01", endAt: "2025-06-30" }
                                    contents: "이력서 생성, 조회, 수정, 삭제 API 설계 및 구현"
                                }
                            }
                        }
                    ]
                }
                {
                    type: CAREER
                    displayOrder: 4.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                career: {
                                    companyName: "잡도리"
                                    role: "Backend Developer"
                                    period: { startAt: "2024-01-01", endAt: "2025-12-31" }
                                    contents: "채용 플랫폼 백엔드 개발 및 운영"
                                }
                            }
                        }
                    ]
                }
                {
                    type: EDUCATION
                    displayOrder: 5.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                education: {
                                    schoolName: "잡도리대학교"
                                    major: "컴퓨터공학"
                                    degree: "BACHELOR"
                                    status: "GRADUATED"
                                    period: { startAt: "2018-03-01", endAt: "2024-02-29" }
                                }
                            }
                        }
                    ]
                }
                {
                    type: AWARD
                    displayOrder: 6.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                award: {
                                    name: "잡도리 해커톤 대상"
                                    organization: "잡도리 테크랩"
                                    awardedAt: "2024-08-01"
                                }
                            }
                        }
                    ]
                }
                {
                    type: LANGUAGE
                    displayOrder: 7.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                language: {
                                    examName: "TOEIC"
                                    scoreOrGrade: "900"
                                    acquiredAt: "2024-03-15"
                                }
                            }
                        }
                    ]
                }
                {
                    type: CERTIFICATE
                    displayOrder: 8.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                certificate: {
                                    name: "정보처리기사"
                                    organization: "한국산업인력공단"
                                    acquiredAt: "2024-05-20"
                                }
                            }
                        }
                    ]
                }
                {
                    type: SKILL
                    displayOrder: 9.0
                    visible: true
                    useDefaultItems: false
                    items: [
                        {
                            displayOrder: 1.0
                            visible: true
                            payload: {
                                skill: {
                                    name: "Kotlin"
                                    level: "HIGH"
                                }
                            }
                        }
                    ]
                }
            ]
        }
    ) {
        resumeId
        targetJd {
            jdId
            sourceUrl
            companyName
            positionTitle
            companyIntro
            responsibilities
            requiredExperiences
            preferredExperiences
            hiringProcess
            coreCompetencies
            insight {
                strategy
            }
            status
            createdAt
        }
        template
        status
        createdAt
        sections {
            sectionId
            type
            displayText
            displayOrder
            visible
            items {
                itemId
                displayOrder
                visible
                payload {
                    basicInfo { name email phone hideContact }
                    coreSkill { content }
                    experience {
                        name
                        role
                        period { startAt endAt }
                        contents
                    }
                    career {
                        companyName
                        role
                        period { startAt endAt }
                        contents
                    }
                    education {
                        schoolName
                        major
                        degree
                        status
                        period { startAt endAt }
                    }
                    award { name organization awardedAt }
                    language { examName scoreOrGrade acquiredAt }
                    certificate { name organization acquiredAt }
                    skill { name level }
                }
            }
        }
    }
}

mutation DeleteResume {
    deleteResume(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        resumeId: 94123123213123123
    )
}

query Jd {
    jd(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        id: "00000000-0000-0000-0000-00000000000a"
    ) {
        jdId
        sourceUrl
        companyName
        positionTitle
        companyIntro
        responsibilities
        requiredExperiences
        preferredExperiences
        hiringProcess
        coreCompetencies
        insight {
            strategy
        }
        status
        createdAt
    }
}

query Jds {
    jds(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        sort: LATEST
        status: IN_PROGRESS
    ) {
        jdId
        companyName
        positionTitle
        status
        createdAt
    }
}

mutation RegisterJd {
    registerJd(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        request: { sourceUrl: "https://example.com/jd" }
    ) {
        jd {
            jdId
            companyName
            positionTitle
            insight {
                strategy
            }
            status
        }
        candidates {
            title
            body
        }
    }
}

mutation MarkJdCompleted {
    markJdCompleted(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        id: "00000000-0000-0000-0000-00000000000a"
    ) {
        jdId
        status
    }
}

query Profile {
    profile(workspaceId: "00000000-0000-0000-0000-000000000002") {
        profileId
        name
        phone
        email
        coreCompetency
        educations {
            school
            major
            degree
            status
            period {
                startAt
                endAt
            }
        }
        careers {
            company
            position
            period {
                startAt
                endAt
            }
            description
        }
        languageTests {
            testName
            score
            acquiredAt
        }
        awards {
            title
            organization
            awardedAt
        }
        certifications {
            name
            issuer
            acquiredAt
        }
        skills {
            name
            level
        }
    }
}

mutation UpdateProfile {
    updateProfile(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        request: {
            name: "잡도리"
            phone: "010-1111-2222"
            email: "rlajae14@gmail.com"
            coreCompetency: "콘텐츠 기획과 데이터 기반 개선에 강점이 있는 마케터입니다."
            educations: [
                {
                    school: "잡도리대학교"
                    major: "경영학과"
                    degree: BACHELOR
                    status: EXPECTED_GRADUATION
                    period: {
                        startAt: "2020-03-01"
                        endAt: "2026-02-28"
                    }
                }
            ]
            careers: [
                {
                    company: "잡도리컴퍼니"
                    position: "마케팅 인턴"
                    period: {
                        startAt: "2024-07-01"
                        endAt: "2024-12-31"
                    }
                    description: "신규 서비스 런칭 캠페인의 콘텐츠 기획과 성과 분석을 담당했습니다."
                }
            ]
            certifications: [
                {
                    name: "GAIQ"
                    issuer: "Google"
                    acquiredAt: "2024-05-10"
                }
            ]
            skills: [
                {
                    name: "GA4"
                    level: HIGH
                }
            ]
        }
    ) {
        profileId
        name
        phone
        email
        coreCompetency
        educations {
            school
            degree
            status
            period {
                startAt
                endAt
            }
        }
        careers {
            company
            position
            description
        }
        certifications {
            name
            acquiredAt
        }
        skills {
            name
            level
        }
    }
}

mutation GenerateCoreCompetency {
    generateCoreCompetency(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        resumeId: 94123123213123123
        jdId: "00000000-0000-0000-0000-000000000003"
    ) {
        coreCompetency
        strategy
    }
}

mutation PolishProfileText {
    polishProfileText(
        workspaceId: "00000000-0000-0000-0000-000000000002"
        request: {
            text: "런칭 캠페인에서 메시지 A/B 테스트를 수행해서 전환율을 많이 개선했음"
            kind: EXPERIENCE_DESCRIPTION
            structure: BULLET
            instruction: "정중한 어투로, 전환율 수치를 강조"
            title: "콘텐츠 마케팅 캠페인 운영"
            jdId: "00000000-0000-0000-0000-000000000003"
        }
    )
}