Identity API
Read and update the profile of the person who owns a credential, and manage their devices and notifications across workspaces.
Credentials
GETandPATCH /api/v1/meaccept a personal API token or a workspace API key. A workspace key needs a Pro or Enterprise workspace, becauseprofile:readandprofile:writeare not Free scopes./me/feed-preferences,/me/time-preferences, andDELETE /me/avataralso accept a workspace API key. They act on the key's owner in that workspace. A personal API token sends theX-Project-Feed-Workspaceheader.- Session tokens, sent with
X-Project-Feed-Workspace, can read and change your profile, remove your photo, and read and change your account notification defaults and your feed and time tracking preferences. Viewers can too, because these are your own settings. - Session tokens can also manage email addresses, sessions, authenticator apps, and account deletion. Email addresses, sessions, security activity, and the deletion check also accept a personal API token. Step-up, authenticator apps, a new primary address, removing a verified address, and deleting the account need a session token.
- Every other route here needs a personal API token. A workspace key gets 400, so it cannot list memberships, devices, or notifications outside its own workspace.
- Personal tokens work on any plan, and a token that is not allowed into any workspace can still call these routes. Workspace access only limits which workspaces appear in notifications.
For one workspace's notifications and preferences, use the Notifications API.
Endpoints
- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"id": "usr_abc123",
"email": "alex@example.com",
"emailVerified": true,
"displayName": "Alex Rivera",
"customDisplayName": null,
"username": "alex",
"displayNamePreference": "fullname",
"image": "/api/media/avatars/alex.jpg",
"createdAt": 1762446710123,
"updatedAt": 1762556810123
}- Scope
- profile:write
Body parameters
displayNamestring1 to 100 characters after trimming. Marks the name as custom. An empty string clears the custom name.
displayNamePreferencestring"username" or "fullname"
usernamestringYour new username. A taken name, an invalid one, or a change too soon after the last one returns 400.
expectedUpdatedAtnumberThe updatedAt you last read. If your profile has changed since, the request returns 412 and nothing is written. An If-Match header with the ETag does the same.
Request
curl --request PATCH \
--url 'https://projectfeed.app/api/v1/me' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"displayName": "Alex Rivera"
}'Response
{
"id": "usr_abc123",
"email": "alex@example.com",
"emailVerified": true,
"displayName": "Alex Rivera",
"customDisplayName": "Alex Rivera",
"username": "alex",
"displayNamePreference": "fullname",
"image": "/api/media/avatars/alex.jpg",
"createdAt": 1762446710123,
"updatedAt": 1762556810123
}- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/orgs' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"organizations": [
{ "id": "ws_abc123", "slug": "acme", "name": "Acme", "role": "owner", "joinedAt": 1762446710123 },
{ "id": "ws_def456", "slug": "beta", "name": "Beta", "role": "member", "joinedAt": 1762556810123 }
]
}- Scope
- api-keys:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/api-keys' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"apiKeys": [
{
"id": "key_abc123",
"name": "Personal CI",
"keyPrefix": "pf_p_a8d9e7f1",
"permissions": ["profile:read"],
"audienceWorkspaceIds": [],
"audienceMode": "identity_only",
"workspaceAccessVersion": 1,
"audienceSnapshotMode": "explicit",
"createdAt": 1762446710123,
"lastUsedAt": 1762556810123,
"expiresAt": 1770000000000,
"revokedAt": null,
"graceEndsAt": null
}
]
}- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/push-subscriptions' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"subscriptions": [
{
"id": "ps_abc123",
"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) Chrome/123",
"createdAt": 1762446710123,
"lastUsedAt": 1762556810123,
"consecutiveFailures": 0,
"vapidKeyId": "v2"
}
],
"truncated": false
}- Scope
- profile:write
Path parameters
idstringrequiredPush subscription ID (URL path)
Request
curl --request DELETE \
--url 'https://projectfeed.app/api/v1/me/push-subscriptions/ps_abc123' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{ "ok": true, "deletedId": "ps_abc123" }- Scope
- notifications:read
Query parameters
limitnumber1 to 200, default 50
cursorstringnextCursor from the previous page. It is opaque; URL-encode it.
sincenumberOnly notifications created at or after this time, in milliseconds, so the last createdAt you saw comes back. Skip ids you already have. Default: 30 days ago.
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/notifications' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"notifications": [
{
"id": "ntf_abc123",
"type": "mention",
"title": "Alex mentioned you on POST-12",
"body": "Check this out",
"organizationId": "ws_abc123",
"resourceType": "post",
"resourceId": "pst_abc123",
"postId": "pst_abc123",
"commentId": null,
"actorId": "usr_def456",
"aggregateCount": null,
"read": false,
"createdAt": 1762556810123
}
],
"unreadCount": 3,
"hasMore": true,
"nextCursor": "opaque-continuation",
"since": 1759964810123
}- Scope
- notifications:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/notifications/unread-count' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{ "unreadCount": 12 }- Scope
- notifications:write
Body parameters
organizationIdstringWorkspace ID to limit the change to. An empty value returns 400.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/notifications/read-all?organizationId=ws_abc123' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"scope": "account",
"organizationId": null,
"marked": 12,
"scheduledMore": false
}- Scope
- notifications:write
Path parameters
idstringrequiredNotification ID (URL path)
Body parameters
readbooleanrequiredtrue to mark read, false to mark unread
Request
curl --request PATCH \
--url 'https://projectfeed.app/api/v1/me/notifications/ntf_abc123' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"read": true
}'Response
{ "ok": true, "notificationId": "ntf_abc123", "read": true }- Scope
- notifications:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/notification-preferences' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"account": {
"emailNewComment": true,
"emailNewReaction": false,
"emailNewPost": false,
"emailMention": true,
"emailDigest": "daily",
"emailTeamActivity": true,
"emailTasks": true,
"pushNewComment": false,
"pushNewReaction": false,
"pushNewPost": false,
"pushMention": true,
"pushTeamActivity": false,
"pushTasks": false,
"pushAssignments": true,
"pushHandoffs": true,
"inAppNewComment": true,
"inAppNewReaction": true,
"inAppNewPost": true,
"inAppMention": true,
"inAppTeamActivity": true,
"inAppTasks": true,
"inAppSoundEnabled": false,
"inAppTabIndicatorEnabled": true,
"globalMute": false,
"quietHoursEnabled": false,
"chatNewPost": true,
"chatNewComment": true,
"chatNewReaction": false,
"chatMention": true,
"chatReviewFeedback": true,
"chatDigest": "none",
"chatPlatformPreference": "both",
"chatQuietHoursEnabled": false,
"emailAssignments": true,
"inAppAssignments": true,
"emailHandoffs": true,
"inAppHandoffs": true,
"emailDiscussions": true,
"pushDiscussions": false,
"inAppDiscussions": true,
"updatedAt": 1762556810123
},
"overrides": [
{
"organizationId": "ws_abc123",
"emailNewComment": null,
"emailNewReaction": null,
"emailNewPost": null,
"emailMention": null,
"emailDigest": null,
"emailTeamActivity": null,
"emailTasks": null,
"emailAssignments": null,
"emailHandoffs": null,
"emailDiscussions": null,
"pushNewComment": null,
"pushNewReaction": null,
"pushNewPost": null,
"pushMention": null,
"pushTeamActivity": null,
"pushTasks": null,
"pushAssignments": null,
"pushHandoffs": null,
"pushDiscussions": null,
"inAppNewComment": null,
"inAppNewReaction": null,
"inAppNewPost": null,
"inAppMention": null,
"inAppTeamActivity": null,
"inAppTasks": null,
"inAppAssignments": null,
"inAppHandoffs": null,
"inAppDiscussions": null,
"inAppSoundEnabled": null,
"inAppTabIndicatorEnabled": null,
"globalMute": true,
"quietHoursEnabled": null,
"quietHoursStart": null,
"quietHoursEnd": null,
"quietHoursTimezone": null,
"chatNewPost": null,
"chatNewComment": null,
"chatNewReaction": null,
"chatMention": null,
"chatReviewFeedback": null,
"chatDigest": null,
"chatPlatformPreference": null,
"chatQuietHoursEnabled": null,
"chatAnnotationEnabled": null,
"createdAt": 1762000000000,
"updatedAt": 1762556810123
}
],
"hasAccountRow": true,
"overridesTruncated": false
}- Scope
- notifications:write
Body parameters
expectedUpdatedAtnumberaccount.updatedAt from your last read. If the account defaults have changed since, the request returns 412 and nothing is written. An If-Match header with the ETag does the same.
<preference field>boolean | stringAny of the fields in the GET response. Toggles are booleans, including globalMute, quietHoursEnabled, inAppSoundEnabled, and inAppTabIndicatorEnabled. quietHoursStart, quietHoursEnd, and quietHoursTimezone are strings. emailDigest is daily, weekly, or never. chatDigest is none, daily, or weekly. chatPlatformPreference is slack, discord, or both.
Request
curl --request PATCH \
--url 'https://projectfeed.app/api/v1/me/notification-preferences' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"emailDigest": "weekly",
"quietHoursEnabled": true
}'Response
{ "ok": true, "created": false, "id": "ntp_abc123", "updatedAt": 1762556810123 }- Scope
- profile:read
Query parameters
scopestringworkspace (default) or account. account reads or changes your account defaults, which every workspace starts from. A workspace API key gets 403 for account.
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/feed-preferences' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"source": "account",
"preferences": {
"showPostPublished": true,
"showPostComments": true,
"showPostReviews": true,
"showPostEdits": null,
"showTaskMilestones": null,
"showTaskComments": null,
"showTaskFieldChanges": null,
"showTaskMicroChanges": false,
"showCanvasCreated": null,
"showDocsActivity": null,
"showTimeTracking": null,
"showProjectActivity": null,
"showMemberActivity": null,
"showIntegrationActivity": null,
"showIntegrationCommits": null,
"showIntegrationReviews": null,
"showIntegrationDeployments": null,
"showIntegrationIssues": null,
"showIntegrationDesign": null
},
"updatedAt": 1779680000000
}- Scope
- profile:write
Query parameters
scopestringworkspace (default) or account. account reads or changes your account defaults, which every workspace starts from. A workspace API key gets 403 for account.
Body parameters
expectedUpdatedAtnumberThe updatedAt you last read, 0 when nothing was saved yet. If the preferences changed since, the request returns 412 and nothing is written. An If-Match header with the ETag does the same.
<preference field>booleanAny of the preference names in the Feed preferences section. true shows that kind of activity and false hides it.
Request
curl --request PATCH \
--url 'https://projectfeed.app/api/v1/me/feed-preferences' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"expectedUpdatedAt": 1
}'Response
{
"source": "account",
"preferences": {
"showPostPublished": true,
"showPostComments": true,
"showPostReviews": true,
"showPostEdits": null,
"showTaskMilestones": null,
"showTaskComments": null,
"showTaskFieldChanges": null,
"showTaskMicroChanges": false,
"showCanvasCreated": null,
"showDocsActivity": null,
"showTimeTracking": null,
"showProjectActivity": null,
"showMemberActivity": null,
"showIntegrationActivity": null,
"showIntegrationCommits": null,
"showIntegrationReviews": null,
"showIntegrationDeployments": null,
"showIntegrationIssues": null,
"showIntegrationDesign": null
},
"updatedAt": 1779680000000
}- Scope
- profile:read
Query parameters
scopestringworkspace (default) or account. account reads or changes your account preferences. A workspace API key gets 403 for account.
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/time-preferences' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"scope": "workspace",
"preferences": {
"idleDetectionEnabled": true,
"idleThresholdMinutes": 10,
"idleAutoAction": "keep",
"idlePermissionAsked": false,
"weeklyTargetHours": 32,
"dailyReminderEnabled": true,
"dailyReminderOnWeekends": false,
"dailyReminderTimezone": "Europe/Berlin"
},
"updatedAt": 1779680000000
}- Scope
- profile:write
Query parameters
scopestringworkspace (default) or account. account reads or changes your account preferences. A workspace API key gets 403 for account.
Body parameters
expectedUpdatedAtnumberThe updatedAt you last read, 0 when nothing was saved yet. If the preferences changed since, the request returns 412 and nothing is written. An If-Match header with the ETag does the same.
weeklyTargetHoursnumberHours to log each week, 1 to 100. null clears the target.
dailyReminderEnabledbooleanRemind the owner on days with no time logged.
dailyReminderOnWeekendsbooleanAlso send the reminder on weekends.
dailyReminderTimezonestringIANA timezone for the reminder, such as Europe/Berlin.
idleDetectionEnabledbooleanPause the timer when the owner is away.
idleThresholdMinutesnumberMinutes away before the timer pauses: 5, 10, 15, or 30.
idleAutoActionstringWhat happens to idle time: keep, discard, or stop.
idlePermissionAskedbooleanWhether the owner was already asked about idle detection.
Request
curl --request PATCH \
--url 'https://projectfeed.app/api/v1/me/time-preferences' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"expectedUpdatedAt": 1
}'Response
{
"scope": "workspace",
"preferences": {
"idleDetectionEnabled": true,
"idleThresholdMinutes": 10,
"idleAutoAction": "keep",
"idlePermissionAsked": false,
"weeklyTargetHours": 32,
"dailyReminderEnabled": true,
"dailyReminderOnWeekends": false,
"dailyReminderTimezone": "Europe/Berlin"
},
"updatedAt": 1779680000000
}- Scope
- profile:write
Request
curl --request DELETE \
--url 'https://projectfeed.app/api/v1/me/avatar' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
HTTP/1.1 204 No Content- Scope
- profile:write
Body parameters
actionstringrequiredWhat the step-up token will allow: delete_account, set_primary_email, remove_email, add_authenticator, remove_authenticator, remove_admin, demote_admin, transfer_ownership, or delete_workspace.
targetstringThe email address ID, authenticator ID, user ID or workspace ID the change is for. Required for set_primary_email, remove_email, remove_authenticator, remove_admin and demote_admin (the admin), transfer_ownership (the new owner) and delete_workspace (the workspace). The token works only on that one.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/step-up' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"action": "set_primary_email",
"target": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2b"
}'Response
{
"id": "k17bq8d1z5e4xw0r9y3m6n2c4v8h7j5t",
"action": "set_primary_email",
"target": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2b",
"expiresAt": 1767226200000
}- Scope
- profile:write
Path parameters
idstringrequiredRequest id from POST /api/v1/me/step-up.
Body parameters
codestringrequiredThe 6-digit code from the email.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/step-up/id_abc123/verify' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"code": "123456"
}'Response
{
"token": "step_up_token_example",
"action": "set_primary_email",
"target": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2b",
"expiresAt": 1767225900000
}- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/emails' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"emails": [
{
"id": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2a",
"email": "dana@northwind.example",
"isPrimary": true,
"verified": true,
"verifiedAt": 1767225600000,
"source": "auth",
"createdAt": 1767225600000
},
{
"id": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2b",
"email": "dana@example.com",
"isPrimary": false,
"verified": false,
"verifiedAt": null,
"source": "manual",
"createdAt": 1767225600000
}
]
}- Scope
- profile:write
Body parameters
emailstringrequiredThe address to add.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/emails' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "dana@example.com"
}'Response
{
"id": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2b",
"email": "dana@example.com",
"isPrimary": false,
"verified": false,
"verifiedAt": null,
"source": "manual",
"createdAt": 1767225600000
}- Scope
- profile:write
Path parameters
idstringrequiredEmail address ID, from GET /api/v1/me/emails.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/emails/id_abc123/verification' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
HTTP/1.1 204 No Content- Scope
- profile:write
Path parameters
idstringrequiredEmail address ID, from GET /api/v1/me/emails.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/emails/id_abc123/primary' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"emails": [
{
"id": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2a",
"email": "dana@northwind.example",
"isPrimary": true,
"verified": true,
"verifiedAt": 1767225600000,
"source": "auth",
"createdAt": 1767225600000
},
{
"id": "j57a8x0c0ab0n2sdq4k7m3e1d97s8r2b",
"email": "dana@example.com",
"isPrimary": false,
"verified": false,
"verifiedAt": null,
"source": "manual",
"createdAt": 1767225600000
}
]
}- Scope
- profile:write
Path parameters
idstringrequiredEmail address ID, from GET /api/v1/me/emails.
Request
curl --request DELETE \
--url 'https://projectfeed.app/api/v1/me/emails/id_abc123' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
HTTP/1.1 204 No Content- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/deletion' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"canDelete": false,
"blockingOrgs": [
{
"id": "jd7b0c5k8vmx1f2a9q3r6w4t8n7p2s5e",
"name": "Northwind",
"slug": "northwind",
"reason": "owner_with_members",
"memberCount": 4
}
]
}- Scope
- profile:write
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/deletion' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"deleted": true,
"signInRemovalPending": false
}- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/sessions' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"sessions": [
{
"id": "session_01JBX9K3T6Q2V8W4M7N5R1C0ZD",
"ipAddress": "203.0.113.24",
"userAgent": "Project Feed for Mac",
"createdAt": "2026-11-01T09:12:00.000Z",
"lastActiveAt": "2026-11-03T08:40:00.000Z",
"current": true
}
]
}- Scope
- profile:write
Path parameters
idstringrequiredSession ID, from GET /api/v1/me/sessions.
Request
curl --request DELETE \
--url 'https://projectfeed.app/api/v1/me/sessions/id_abc123' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
HTTP/1.1 204 No Content- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/security-activity' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"events": [
{
"id": "k57c2r8d0x4m1v6b9n3q5w7e2t8y4u1i",
"timestamp": 1767225600000,
"eventType": "auth.login",
"eventCategory": "authentication",
"action": "login",
"status": "success",
"actorIp": "203.0.113.24",
"actorUserAgent": "Project Feed for Mac",
"organizationId": "jd7b0c5k8vmx1f2a9q3r6w4t8n7p2s5e",
"resourceType": "user",
"resourceName": null,
"errorMessage": null
}
]
}- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/authenticators' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"authenticators": [
{
"id": "auth_factor_01JBXA2C4E6G8J0K2M4P6R8T0V",
"createdAt": "2026-11-02T10:00:00.000Z",
"updatedAt": "2026-11-02T10:00:00.000Z",
"pending": false
}
]
}- Scope
- profile:write
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/authenticators' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"id": "auth_factor_01JBXA2C4E6G8J0K2M4P6R8T0V",
"challengeId": "auth_challenge_01JBXA2C4E6G8J0K2M4P6R8T0W",
"qrCode": "data:image/png;base64,iVBORw0KGgo=",
"secret": "JBSWY3DPEHPK3PXP",
"uri": "otpauth://totp/Project%20Feed:dana%40northwind.example?secret=JBSWY3DPEHPK3PXP&issuer=Project%20Feed"
}- Scope
- profile:write
Path parameters
idstringrequiredAuthenticator ID from POST /api/v1/me/authenticators.
Body parameters
challengeIdstringrequiredchallengeId from POST /api/v1/me/authenticators.
codestringrequiredThe 6-digit code the app shows.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/authenticators/id_abc123/verify' \
--header 'Authorization: Bearer pf_YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"challengeId": "auth_challenge_01JBXA2C4E6G8J0K2M4P6R8T0W",
"code": "123456"
}'Response
{
"verified": true
}- Scope
- profile:write
Path parameters
idstringrequiredAuthenticator ID, from GET /api/v1/me/authenticators.
Request
curl --request DELETE \
--url 'https://projectfeed.app/api/v1/me/authenticators/id_abc123' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
HTTP/1.1 204 No Content- Scope
- profile:read
Request
curl --request GET \
--url 'https://projectfeed.app/api/v1/me/invitations' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"invitations": [
{
"id": "jh7c2v9x4kq8m1n5p3r6s0t2w8y4z6a1",
"workspaceId": "jd7b0c5k8vmx1f2a9q3r6w4t8n7p2s5e",
"workspaceName": "Northwind",
"workspaceSlug": "northwind",
"workspaceLogoUrl": null,
"role": "member",
"inviterName": "Jane Smith"
}
]
}- Scope
- profile:write
Path parameters
idstringrequiredInvitation ID, from GET /api/v1/me/invitations.
Request
curl --request POST \
--url 'https://projectfeed.app/api/v1/me/invitations/id_abc123/accept' \
--header 'Authorization: Bearer pf_YOUR_API_KEY'Response
{
"id": "jd7b0c5k8vmx1f2a9q3r6w4t8n7p2s5e",
"name": "Northwind",
"slug": "northwind",
"role": "member"
}Feed preferences
The activity feed shows what you can see in the app, minus the kinds you hide. These preferences are per workspace. The first change to a workspace copies your account defaults and saves them as that workspace's own setting. Send scope=account to read or change the account defaults instead. The preference names are: showPostPublished, showPostComments, showPostReviews, showPostEdits, showTaskMilestones, showTaskComments, showTaskFieldChanges, showTaskMicroChanges, showCanvasCreated, showDocsActivity, showTimeTracking, showProjectActivity, showMemberActivity, showIntegrationActivity, showIntegrationCommits, showIntegrationReviews, showIntegrationDeployments, showIntegrationIssues, showIntegrationDesign.
Your own activity counts and charts are on the Reports API.
Step-up
Changes that could lock someone out of their account need a fresh email code, not just a signed-in session: deleting the account, changing the primary address, removing a verified address, adding an authenticator app, and removing one. From an app session, removing a workspace admin or moving one to member or viewer, transferring ownership and deleting a workspace need one too.
POST /api/v1/me/step-upwith the action, and the address, authenticator or user ID when there is one, emails a code.POST /api/v1/me/step-up/:id/verifywith the code returns a token.- Send the token in the
X-Project-Feed-Step-Upheader on the change. It works once, within 5 minutes, from the same session, for that action and target only.