POST /api/auth/google

Authentication flow · HTTP API reference

All endpoints · Authentication and retries · Download OpenAPI

Part of a browser authentication or connection flow. Keep the flow's state and cookies; provider values in examples must come from that flow.

Request

No path, query or custom header parameters.

Body · application/json

credential required · string

intent optional · string

referralCode optional · string

Example

Examples use fictional data. Replace identifiers with resources you can access. For account requests, cookies.txt must contain your own session; set CSRF_TOKEN to the matching CSRF cookie value where required.

Save as request.json

{
  "credential": "REPLACE_WITH_YOUR_FLOW_VALUE"
}

cURL (POSIX shell)

curl --include \
  --request POST \
  'https://api.weavers.app/api/auth/google' \
  --cookie cookies.txt --cookie-jar cookies.txt \
  --header 'Content-Type: application/json' \
  --data-binary @request.json

Responses

200 · Successful response.

application/json

200 example · synthetic data

{
  "message": "Explain the data used in this research.",
  "user": {
    "id": 1,
    "name": "Example research",
    "email": "developer@example.com"
  },
  "coinAward": null
}

View response model

message required · string

user required · object

View user model

id required · number

name required · string

email required · string

Additional fields: JSON values.

coinAward required · null | object

View coinAward model

Variant 1: null

null

Variant 2: object

amount required · number

balance required · number

Additional fields: JSON values.

201 · Resource created.

application/json

201 example · synthetic data

{
  "message": "Explain the data used in this research.",
  "user": {
    "id": 1,
    "name": "Example research",
    "email": "developer@example.com"
  },
  "coinAward": null
}

View response model

message required · string

user required · object

View user model

id required · number

name required · string

email required · string

Additional fields: JSON values.

coinAward required · null | object

View coinAward model

Variant 1: null

null

Variant 2: object

amount required · number

balance required · number

Additional fields: JSON values.

400 · Invalid request.

application/json

400 example · synthetic data

{
  "error": "example"
}

View response model

Variant 1: object

error required · string

Additional fields: JSON values.

Variant 2: object

error required · string

message required · string

Additional fields: JSON values.

401 · Authentication is missing or invalid.

application/json

401 example · synthetic data

{
  "error": "example",
  "message": "Explain the data used in this research."
}

View response model

error required · string

message required · string

Additional fields: JSON values.

403 · Permission, origin or CSRF check failed.

application/json

403 example · synthetic data

{
  "error": "example",
  "message": "Explain the data used in this research."
}

View response model

error required · string

message required · string

Additional fields: JSON values.

409 · Revision, state or idempotency conflict.

application/json

409 example · synthetic data

{
  "error": "example",
  "message": "Explain the data used in this research.",
  "existingUser": false,
  "authProvider": "example"
}

View response model

error required · string

message required · string

existingUser required · boolean

authProvider required · string

Additional fields: JSON values.

429 · Rate limit reached; honor Retry-After when supplied.

application/json

429 example · synthetic data

{}

View response model

Error envelopes can include resource-specific details. Check the status before reading these fields.

error optional · string

code optional · string

message optional · string

Additional fields: JSON values.

500 · Server failure.

application/json

500 example · synthetic data

{
  "error": "example"
}

View response model

Variant 1: object

error required · string

Additional fields: JSON values.

Variant 2: object

error required · string

message required · string

Additional fields: JSON values.