Skip to content
Docs
Get early access

Exchange email and password for tokens

POST
/v1/auth/login
curl --request POST \
  --url https://api.wirevod.online/v1/auth/login \
  --header 'Content-Type: application/json' \
  --data '{ "email": "owner@example.com", "password": "correct-horse-battery-staple" }'

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
email
required
string format: email
<= 254 characters
password
required
string
Example
{
  "email": "owner@example.com",
  "password": "correct-horse-battery-staple"
}

Responses

Section titled “ Responses ”

200

Section titled “200”

Credentials accepted.

Media typeapplication/json
object
user
required
object
id
required
string
tenant_id
required
string
email
required
string format: email
email_verified
required
boolean
name
required
string | null
role
required
string
Allowed values: owner admin member
created_at
required
integer
access_token
required
string
refresh_token
required
string
token_type
required
string
Allowed values: bearer
expires_in
required
integer
Example
{
  "user": {
    "id": "usr_01J9Z",
    "tenant_id": "ten_01J9Z",
    "email": "owner@example.com",
    "email_verified": true,
    "name": "Ada Lovelace",
    "role": "owner",
    "created_at": 1760000000000
  },
  "access_token": "eyJhbGciOiJIUzI1NiJ9.access",
  "refresh_token": "wvr_9f2c.refresh",
  "token_type": "bearer",
  "expires_in": 900
}

400

Section titled “400”

The request was malformed or failed validation.

Media typeapplication/json
object
error
required
string
code
required
string
message
required
string
details
Example
{
  "error": "invalid_request",
  "code": "invalid_request",
  "message": "asset_id is required"
}

401

Section titled “401”

Missing or invalid credentials.

Media typeapplication/json
object
error
required
string
code
required
string
message
required
string
details
Example
{
  "error": "unauthorized",
  "code": "unauthorized",
  "message": "Authentication required"
}

429

Section titled “429”

Too many requests in the current window.

Media typeapplication/json
object
error
required
string
code
required
string
message
required
string
details
Example
{
  "error": "rate_limited",
  "code": "rate_limited",
  "message": "Too many requests",
  "details": {
    "retry_after": 60
  }
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying.

© 2026 WireVoD