Substy Developers
Account and agency

Update account profile

Replace the authenticated user’s firstName and lastName, then return the updated profile. Supply both fields; at least one must be nonempty. Email, password and linked-provider changes use request_account_action.

PATCH/v1/agencies/{agencyId}/account/profile

Replace the authenticated user’s firstName and lastName, then return the updated profile. Supply both fields; at least one must be nonempty. Email, password and linked-provider changes use request_account_action.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://example.com/v1/agencies/string/account/profile" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "firstName": "string",    "lastName": "string"  }'
{  "data": {    "id": "string",    "firstName": null,    "lastName": null,    "imageUrl": "string",    "primaryEmailAddressId": null,    "emails": [      {        "id": "string",        "emailAddress": "string",        "verificationStatus": null      }    ],    "externalAccounts": [      {        "id": "string",        "provider": "string",        "emailAddress": "string"      }    ],    "passwordEnabled": true,    "twoFactorEnabled": true,    "deleteSelfEnabled": true  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Get account profile GET

Read the authenticated user’s profile, primary email ID, email verification statuses, linked sign-in providers and enabled security settings. Use returned email and external-account IDs when requesting sensitive account changes.

List account sessions GET

List the authenticated user’s sign-in sessions with status, last activity, browser, device and location. Supports offset and limit, up to 100 sessions per call; returns totalCount. To revoke a session, pass its ID to request_account_action with kind revoke_session.