> For the complete documentation index, see [llms.txt](https://dev.guardian.hedera.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.guardian.hedera.com/developer-tools-and-resources/api-reference/schema-tags-apis.md).

# Schema Tags APIs

Endpoints for creating, updating, and managing tag schemas — schemas associated with tagging entities in Guardian policies.

**Authentication:** Bearer token required (`Authorization: Bearer <token>`)

***

| Method   | Endpoint                                  | Description                       | Auth Required |
| -------- | ----------------------------------------- | --------------------------------- | ------------- |
| `GET`    | `/api/v1/tags/schemas`                    | Returns all tag schemas           | Yes           |
| `POST`   | `/api/v1/tags/schemas`                    | Creates a new tag schema          | Yes           |
| `PUT`    | `/api/v1/tags/schemas/{schemaId}`         | Updates a tag schema              | Yes           |
| `DELETE` | `/api/v1/tags/schemas/{schemaId}`         | Deletes a tag schema              | Yes           |
| `PUT`    | `/api/v1/tags/schemas/{schemaId}/publish` | Publishes a tag schema            | Yes           |
| `GET`    | `/api/v1/tags/schemas/published`          | Returns all published tag schemas | Yes           |

## Endpoints

* [Returning All Schema Tags](/developer-tools-and-resources/api-reference/schema-tags-apis/returning-all-schema-tags.md)
* [Creating New Schema Tag](/developer-tools-and-resources/api-reference/schema-tags-apis/creating-new-schema-tag.md)
* [Updating Schema Tag](/developer-tools-and-resources/api-reference/schema-tags-apis/updating-schema-tag.md)
* [Deleting Schema Tag](/developer-tools-and-resources/api-reference/schema-tags-apis/deleting-schema-tag.md)
* [Publishing Schema](/developer-tools-and-resources/api-reference/schema-tags-apis/publishing-schema.md)
* [Returning List of Published Schemas](/developer-tools-and-resources/api-reference/schema-tags-apis/returning-list-of-published-schemas.md)