---
title: "(ESM3) Inverse folds proteins. Defaults to esm3-open-2024-03 if no model is given"
method: POST
path: "/api/v1/inverse_fold"
tags: ["v1"]
---

# (ESM3) Inverse folds proteins. Defaults to esm3-open-2024-03 if no model is given

`POST /api/v1/inverse_fold`

## Request

- Base URL: `https://dev.evolutionaryscale.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.evolutionaryscale.ai/api/v1/inverse_fold`
- Auth: HTTP bearer

## Headers

- `accept` string, nullable

## Request body

- InverseFoldRequest
  - `model` 'esm3-open-2024-03' | 'null', nullable: You may have access to additional, private models as well. These will be visible on the Rate Limits page under the Developer Console
  - `potential_sequence_of_concern` boolean: Disclose potential sequences of concern. For approved users, such sequences will not go through additional safety filtering. Reach out if you are interested in using this.
  - `coordinates` array[]: Coordinates of the N, CA, C atom sequence as a Nx37x3 array.
    - array[]
      - number[]
  - `inverse_folding_config` InverseFoldingConfig, required
    - `invalid_ids` integer[]: Token indices that should not be sampled.
    - `temperature` number: Temperature for sampling. For inverse folding models, we recommend getting diverse predictions by changing the seed and not by increasing the temperature.
  - `sequence` string, nullable: Sequence for sequence conditioning.

## Response `200`

Successful Response

- InverseFoldResponse
  - `model` 'esm3-open-2024-03', required: You may have access to additional, private models as well. These will be visible on the Rate Limits page under the Developer Console
  - `created` string, required: ISO formatted date time
  - `potential_sequence_of_concern` boolean: Indicate that the returned sequence may be of potential concerns.
  - `warning_messages` string[], nullable: Warning messages returned by FastAPI.
  - `sequence` string: Inverse folded sequence.

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-23** `cfa834c15600`: 2 info
  - added the new optional `header` request parameter `accept`
  - added the media type `application/vnd.evolutionaryscale.pickle` for the response with the status `200`

[Operation history](https://skmtc.dev/evolutionaryscale/apis/evolutionaryscale-api/changes/api/v1/inverse_fold/post.md)

---

[API](https://skmtc.dev/evolutionaryscale/apis/evolutionaryscale-api.md) - [All operations](https://skmtc.dev/evolutionaryscale/apis/evolutionaryscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/evolutionaryscale/apis/evolutionaryscale-api/revisions/28a490b11fe1?raw)