GET
/
symbol
/
definitions-in-file
Get symbols in a specific file (uses ast-grep)
curl --request GET \
  --url http://localhost:4444/v1/symbol/definitions-in-file \
  --header 'Authorization: Bearer <token>'
[
  {
    "file_range": {
      "path": "src/main.py",
      "range": {
        "end": {
          "character": 5,
          "line": 10
        },
        "start": {
          "character": 5,
          "line": 10
        }
      }
    },
    "identifier_position": {
      "path": "src/main.py",
      "position": {
        "character": 5,
        "line": 10
      }
    },
    "kind": "class",
    "name": "User"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
file_path
string
required

The path to the file to get the symbols for, relative to the root of the workspace.

Response

200
application/json

Symbols retrieved successfully

The response is of type object[].