---
updatedAt: 2026-08-31T17:33:07.000Z
agentTools:
  projectIndex: https://docs.reev.com/llms.txt
---

# /auth

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "reev API",
    "version": "2024-08-01"
  },
  "servers": [
    {
      "url": "https://api.reev.com"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/auth": {
      "post": {
        "tags": [
          "reev-api-auth-api"
        ],
        "operationId": "authenticate",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReevApiAuthRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ReevApiTokenResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid Request",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "type": {},
                    "title": {},
                    "status": {},
                    "detail": {},
                    "instance": {},
                    "properties": {}
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized request",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "type": {},
                    "title": {},
                    "status": {},
                    "detail": {},
                    "instance": {},
                    "properties": {}
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "properties": {
                    "type": {},
                    "title": {},
                    "status": {},
                    "detail": {},
                    "instance": {},
                    "properties": {}
                  }
                }
              }
            }
          }
        },
        "security": []
      }
    }
  },
  "components": {
    "schemas": {
      "ReevApiAuthRequest": {
        "type": "object",
        "properties": {
          "clientId": {
            "type": "string",
            "minLength": 1
          },
          "clientSecret": {
            "type": "string",
            "minLength": 1
          }
        },
        "required": [
          "clientId",
          "clientSecret"
        ]
      },
      "ReevApiTokenResponse": {
        "type": "object",
        "properties": {
          "access_token": {
            "type": "string"
          },
          "expires_in": {
            "type": "integer",
            "format": "int64"
          },
          "token_type": {
            "type": "string"
          },
          "scope": {
            "type": "string"
          }
        },
        "required": [
          "access_token",
          "expires_in",
          "token_type"
        ]
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "x-readme": {}
}
```