Mojo Motivators. AI insights included ONLY for authorised viewers.

GET

/users/{userId}/motivators

curl --request GET \
  --url https://api.gospl.example/v1/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/motivators \
  --header 'Authorization: Bearer <token>'

• Production (placeholder)
• Mock server (generated from this contract)

Motivators summary is returned to any authorised viewer. The aiInsights field MUST be present only when the viewer is the profile owner or holds elevated permission; otherwise it MUST be absent from the response body (FR-10). BLOCKED on Mojo API readiness (OQ-01).

Authorizations

• bearerAuth

Parameters

Path Parameters

userId

required

string format: uuid

Responses

200

OK

Media type application/json

object

motivators

required

Array<object>

object

name

string

score

number

lastSyncedAt

required

Stale-data indicator for the Mojo pull.

string format: date-time

aiInsights

Mojo AI-generated insight. MUST be present ONLY when viewer is owner or elevated (FR-09/10/11). Absent otherwise.

string

Example ^generated

{
  "motivators": [
    {
      "name": "example",
      "score": 1
    }
  ],
  "lastSyncedAt": "2026-04-15T12:00:00Z",
  "aiInsights": "example"
}

401

Missing/invalid credentials.

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}

403

Authenticated but not permitted (incl. cross-tenant).

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}

404

Not found within the caller’s tenant.

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}

503

Mojo upstream unavailable; serve cached value if present.

Media type application/json

object

code

required

string

message

required

string

Example ^generated

{
  "code": "example",
  "message": "example"
}