> For the complete documentation index, see [llms.txt](https://docs.panther.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.panther.com/ko/panther/api/graphql/schemas.md).

# 스키마

## 개요

Panther API는 다음 스키마 작업을 지원합니다:

* 사용자 지정 스키마 생성 또는 업데이트
* 스키마 목록 조회

Console의 API Playground 또는 GraphQL-over-HTTP API를 사용하여 Panther의 API를 호출할 수 있습니다. 이러한 방법에 대해 자세히 알아보려면 [Panther API](/ko/panther/api.md#step-1-choose-a-method-for-invoking-the-api).

다음을 참조하세요: [사용자 지정 로그](/ko/data-onboarding/custom-log-types.md) Panther의 사용자 지정 스키마에 대해 자세히 알아보세요.

### 필수 API 토큰 권한

API 호출을 시작하기 전에 API 토큰에 필요한 권한이 부여되어 있는지 확인하세요:

* **로그 소스 보기**: 모든 스키마 작업에 필요합니다.
* **로그 소스 관리**: 변이(mutation)인 스키마 관리 작업에 필요합니다(즉, `CreateOrUpdateSchema`).
* **사용자 정보 읽기**: 행위자와 관련된 통합 필드(예: `createdBy`.

<figure><img src="/files/04445b87d6f4f3280f1274f5aa1b7a16f382c405" alt="An &#x22;Integrations&#x22; header is above four checkboxes: View Cloud Security Sources, Manage Cloud Security Sources, View Log Sources, and Manage Log Sources."><figcaption></figcaption></figure>

## 공통 스키마 작업

#### 사용자 지정 스키마 생성

```graphql
mutation addSchema {
  createOrUpdateSchema(input:{
    description: "설명"
    name:"Custom.NewSchema",
    isFieldDiscoveryEnabled: true,
    spec:"""
    필드:
     - name: foo
       유형: 문자열
    """
  }) {
    schema {
      createdAt
      description
      isArchived
      isManaged
      name
      referenceURL
      revision
      isFieldDiscoveryEnabled
      spec
      discoveredSpec
      updatedAt
      version
    }
  }
}
```

#### 스키마 목록 조회

이 쿼리는 사용자 지정 및 Panther 관리 스키마를 포함한 모든 스키마를 나열합니다.

{% hint style="info" %}
현재는 다음에 대해 페이지 매김이 지원되지 않습니다: `schemas`—모든 스키마가 결과의 첫 번째 페이지에 반환됩니다. 아래의 `cursor` 필드로 지정되며, `input` object는 나중에 페이지 매김이 지원될 때를 위한 자리 표시자입니다.
{% endhint %}

```graphql
query ListSchemas {
  schemas(input:{cursor:""}) {
    edges {
      node {
        createdAt
        description
        isArchived
        isManaged
        name
        referenceURL
        revision
        isFieldDiscoveryEnabled
        spec
        discoveredSpec
        updatedAt
        version
      }
    }
  }
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.panther.com/ko/panther/api/graphql/schemas.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.