Skip to main content
POST
/
v2
/
code
/
rank
cURL
curl --request POST \
  --url https://ranker.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

I