Auth

View as Markdown

Complete Signup

POST/api/v1/auth/signup/complete

Complete signup by creating a user profile, brand, and membership.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/auth/signup/complete" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Signup With Invite

POST/api/v1/auth/signup/with-invite

Complete signup using an invitation token.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/auth/signup/with-invite" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Accept Invite

POST/api/v1/auth/accept-invite

Accept an invitation as an existing user (already logged in).

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/auth/accept-invite" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Get Me Summary

GET/api/v1/auth/me/summary

Return only account-menu identity for an existing session user.

Request
curl "https://app.opvs.ai/api/v1/auth/me/summary" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Me

GET/api/v1/auth/me

Get current user profile with all brand memberships.

Request
curl "https://app.opvs.ai/api/v1/auth/me" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Update Profile

PATCH/api/v1/auth/profile

Update current user's profile (name, phone).

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X PATCH "https://app.opvs.ai/api/v1/auth/profile" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Upload Profile Photo

POST/api/v1/auth/profile/photo

Upload profile picture. Resizes to 256×256 JPEG and stores in Cloudflare R2.

Errors

CodeWhenWhat to do
422Validation Error—
Request
curl -X POST "https://app.opvs.ai/api/v1/auth/profile/photo" \
  -H "Authorization: Bearer $OPVS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Remove Profile Photo

DELETE/api/v1/auth/profile/photo

Remove profile picture. Cleans up R2 file if stored there.

Request
curl -X DELETE "https://app.opvs.ai/api/v1/auth/profile/photo" \
  -H "Authorization: Bearer $OPVS_TOKEN"

Get Connectors

GET/api/v1/auth/connectors

List connected OAuth providers for the current user.

Request
curl "https://app.opvs.ai/api/v1/auth/connectors" \
  -H "Authorization: Bearer $OPVS_TOKEN"
Did this answer your question?