Skip to main content
POST
/
v2
/
code
/
rank
cURL
curl --request POST \
  --url https://instantapply.endpoint.relace.run/v2/code/rank \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "Optimize the search function for better performance with large arrays",
  "codebase": [
    {
      "filename": "src/search.ts",
      "content": "function findItem(array: Item[], targetId: string): Item | undefined {\\n  for (let i = 0; i < array.length; i++) {\\n    const item = array[i];\\n    if (item.id === targetId) {\\n      return item;\\n}\\n}\\n  return undefined;\\n}"
    }
  ],
  "token_limit": 100000
}
'
{
  "results": [
    {
      "filename": "src/search.ts",
      "score": 0.953125
    }
  ],
  "usage": {
    "total_tokens": 96
  }
}

Authorizations

​
Authorization
string
header
required

Relace API key Authorization header using the Bearer scheme.

Body

application/json

Query and codebase context for relevance scoring

​
query
string
required

The natural language query describing the problem to solve

​
codebase
object[]
required

An array of files with their content, providing context for the query

​
token_limit
integer
default:100000
required

Maximum token limit for the response

​
relace_metadata
object

Optional metadata for logging and tracking purposes. Removed before forwarding to origin server.

Response

Codebase reranked successfully

​
results
object[]

Array of files ranked by relevance to the query, with their scores

Example:
[
  {
    "filename": "src/search.ts",
    "score": 0.953125
  }
]
​
usage
object

Token usage information for the request