Fulcra User API
The user API from Fulcra — 2 operation(s) for user.
The user API from Fulcra — 2 operation(s) for user.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/fulcradynamics-com:fulcradynamics-com-user-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
contact:
email: contact@fulcradynamics.com
name: Fulcra Dynamics
url: https://www.fulcradynamics.com/
description: REST API for interacting with the Fulcra Platform and Data Store
termsOfService: https://www.fulcradynamics.com/legal/terms-of-use
title: Fulcra Life User API
version: 1.0.0
servers:
- url: https://api.fulcradynamics.com
description: Fulcra Life API
security:
- bearerAuth: []
tags:
- name: User
paths:
/user/v1alpha1/info:
get:
description: Returns information for the authenticated Fulcra user including current preferences (time zone, calendars, etc).
operationId: get_user_info
parameters:
- in: query
name: platform
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Platform
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/V1Alpha1UserResponse'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Return authenticated user information
tags:
- User
/user/v1alpha1/preferences:
get:
description: Return the current preferences and settings for the authenticated Fulcra user
operationId: get_user_preferences
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FulcraUserPreferences'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Return current user preferences
tags:
- User
post:
description: Set current preferences for the authenticated Fulcra user
operationId: set_user_preferences
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FulcraUserPreferences'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/FulcraUserPreferences'
description: Successful Response
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
description: Validation Error
summary: Set user preferences
tags:
- User
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
title: Detail
type: array
title: HTTPValidationError
type: object
FulcraServiceStatus:
description: 'The service status (i.e. subscription status) for a user.
This includes paid subscriptions plus any extra free time/etc. granted
by Fulcra.'
properties:
active_until:
format: date-time
title: Active Until
type: string
grace_period_ends:
format: date-time
title: Grace Period Ends
type: string
is_active:
title: Is Active
type: boolean
manage_url:
anyOf:
- type: string
- type: 'null'
title: Manage Url
service_type:
$ref: '#/components/schemas/FulcraServiceType'
required:
- is_active
- service_type
- active_until
- grace_period_ends
- manage_url
title: FulcraServiceStatus
type: object
FulcraServiceType:
enum:
- subscribed_apple
- subscribed_stripe
- free_service
- staff
- none
title: FulcraServiceType
type: string
PeriodsOfDay:
additionalProperties: false
properties:
afternoon:
type: string
end_of_day:
type: string
evening:
type: string
morning:
type: string
required:
- morning
- afternoon
- evening
- end_of_day
type: object
FulcraUserPreferences:
description: A Fulcra user's preferences
properties:
calendar_events_data_track_filter_map:
anyOf:
- additionalProperties:
items:
type: string
type: array
type: object
- type: 'null'
title: Calendar Events Data Track Filter Map
calendars:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Calendars
location_resolution:
anyOf:
- additionalProperties:
type: integer
type: object
- type: 'null'
title: Location Resolution
periods_of_day:
anyOf:
- $ref: '#/components/schemas/PeriodsOfDay'
- type: 'null'
default:
afternoon: '12:00:00'
end_of_day: '21:00:00'
evening: '18:00:00'
morning: 08:00:00
description: User defined periods of the day
pinned_metrics_count_map:
anyOf:
- additionalProperties:
type: integer
type: object
- type: 'null'
title: Pinned Metrics Count Map
selected_calendar_vendor_ids:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Selected Calendar Vendor Ids
selected_metrics:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Selected Metrics
selected_metrics_map:
anyOf:
- additionalProperties:
items:
type: string
type: array
type: object
- type: 'null'
title: Selected Metrics Map
timezone:
anyOf:
- type: string
- type: 'null'
title: Timezone
title: FulcraUserPreferences
type: object
V1Alpha1UserResponse:
description: Response for user info
properties:
created:
format: date-time
title: Created
type: string
intercom_token:
anyOf:
- type: string
- type: 'null'
title: Intercom Token
preferences:
$ref: '#/components/schemas/FulcraUserPreferences'
service_status:
$ref: '#/components/schemas/FulcraServiceStatus'
status:
title: Status
type: string
tier:
title: Tier
type: string
userid:
format: uuid
title: Userid
type: string
required:
- userid
- created
- status
- tier
- preferences
- service_status
title: V1Alpha1UserResponse
type: object
ValidationError:
properties:
ctx:
title: Context
type: object
input:
title: Input
loc:
items:
anyOf:
- type: string
- type: integer
title: Location
type: array
msg:
title: Message
type: string
type:
title: Error Type
type: string
required:
- loc
- msg
- type
title: ValidationError
type: object
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT