Profiles
Manage connected social media accounts across Instagram, Facebook, TikTok, LinkedIn, YouTube, Threads, and Reddit via OAuth abstraction.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Query Parameters
platform?string
Filter by social platform
connectionStatus?string
Filter by connection status
Response Body
application/json
application/json
curl -X GET "https://example.com/profiles"{ "success": true, "data": [ { "id": "prof_abc123", "organizationId": "string", "platform": "instagram", "platformAccountId": "string", "username": "aetherhq", "displayName": "Aether HQ", "avatarUrl": "http://example.com", "connectionStatus": "connected", "errorMessage": "string", "tokenExpiresAt": "2019-08-24T14:15:22Z", "lastRefreshedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" } ]}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
profileId*string
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/profiles/string"{ "success": true, "data": { "id": "prof_abc123", "organizationId": "string", "platform": "instagram", "platformAccountId": "string", "username": "aetherhq", "displayName": "Aether HQ", "avatarUrl": "http://example.com", "connectionStatus": "connected", "errorMessage": "string", "tokenExpiresAt": "2019-08-24T14:15:22Z", "lastRefreshedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Revokes the stored OAuth tokens and marks the profile as disconnected. Dispatches a profile.disconnected webhook event to all subscribed endpoints.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
profileId*string
Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/profiles/string"{ "success": true, "data": { "id": "prof_abc123", "organizationId": "string", "platform": "instagram", "platformAccountId": "string", "username": "aetherhq", "displayName": "Aether HQ", "avatarUrl": "http://example.com", "connectionStatus": "connected", "errorMessage": "string", "tokenExpiresAt": "2019-08-24T14:15:22Z", "lastRefreshedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}