Updating & Versioning Specs

Updating a Spec

APIs change over time, and CodeContext makes it easy to keep your specs current. To update a spec, go to the API Specs page, find the spec you want to update, and click "Update." Then upload the new version of your spec file or paste the updated URL.

CodeContext will replace the existing spec data with the new version. All endpoints and schemas will be refreshed to match the updated file.

What Happens on Update

When you update a spec, CodeContext:

1. Parses the new spec file.
2. Replaces all existing endpoint and schema data with the new version.
3. Updates the spec metadata (title, version, description).

The spec name in CodeContext stays the same unless you change it manually. This means any bookmarks or links to the spec will continue to work.

Version History

CodeContext does not currently maintain a full version history of your specs. If you need to keep track of changes over time, we recommend storing your spec files in version control (like Git) and using CodeContext as the browsable, searchable interface on top.

Deleting a Spec

To delete a spec, go to the spec's detail page and click "Delete." This action is permanent — deleted specs cannot be recovered. Make sure you have a backup of the spec file if you might need it later.

Deleting a spec removes all its endpoints and schemas from CodeContext, including from AI tool access via MCP.