# Update a schema

**PUT /groups/{groupId}/apps/{appId}/schemas/{schemaId}**

Replace an existing [schema](https://www.mongodb.com/zh-cn/docs/atlas/app-services/schemas) with a new one.


## Servers
- The root API resource and starting point for the App Services API.: https://services.cloud.mongodb.com/api/admin/v3.0 (The root API resource and starting point for the App Services API.)


## Authentication methods
- Token auth


## Parameters

### Path parameters
- **groupId** (string)
  An Atlas [Project/Group
  ID](https://docs.atlas.mongodb.com/tutorial/manage-projects/).
- **appId** (string)
  The ObjectID of your application.
  [The App Services API Project and Application IDs section](#section/Project-and-Application-IDs) demonstrates how to find this
  value.
- **schemaId** (string)
  The unique `_id` value of a schema.


### Body: application/json (object)

- **metadata** (object)
  Metadata that describes which linked collection the schema applies to.
- **schema** (object)
  A valid [schema](https://www.mongodb.com/zh-cn/docs/atlas/app-services/schemas) for the collection.
- **relationships** (object)
  Relationships to foreign collections. Each field name is a property in the schema. The corresponding value is a [relationship](https://www.mongodb.com/zh-cn/docs/atlas/app-services/schemas/relationships/) definition for that field.


## Responses
### 204
No Content


[Powered by Bump.sh](https://bump.sh)