Skip to main content
POST
/
api
/
v2
/
search
Search Codebase
curl --request POST \
  --url https://production-api.potpie.ai/api/v2/search \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "project_id": "proj_abc123def456",
  "query": "authentication functions"
}
'
{
  "results": [
    {
      "node_id": "func_authenticate_user_123",
      "name": "authenticate_user",
      "file_path": "src/auth/authenticate.py",
      "content": "def authenticate_user(username: str, password: str) -> bool:",
      "match_type": "function",
      "relevance": 0.95
    },
    {
      "node_id": "func_verify_token_456",
      "name": "verify_token",
      "file_path": "src/auth/jwt.py",
      "content": "def verify_token(token: str) -> Optional[Dict]:",
      "match_type": "function",
      "relevance": 0.87
    }
  ]
}

Authorizations

x-api-key
string
header
required

API key authentication. Get your key from potpie settings page

Body

application/json
project_id
string
required

Project to search in

query
string
required

Search query (natural language)

Minimum string length: 1

Response

Search results retrieved successfully

results
object[]