Skip to content
API reference

API reference

PULSE’s API is gRPC. The contracts are the .proto files in grpc/api/proto/pulse/v1/: pulse.proto, activity.proto, and commons.proto, in package pulse.v1. Browsers use gRPC-Web on the same port.

There is no REST API, no webhook registration, and no client library besides the generated stubs (Go in grpc/api/v1/, Dart in flutter/lib/core/grpc/). The few plain HTTP routes are listed under HTTP endpoints.

To call the API, see Calling the API.

Every registered service

ServicePage
pulse.v1.DiagnosticServiceAnalysis
pulse.v1.RadarServiceAnalysis
pulse.v1.InsightsServiceAnalysis
pulse.v1.Customer360ServiceAnalysis
pulse.v1.ContentServiceContent
pulse.v1.StudioServiceContent
pulse.v1.AvatarServiceContent
pulse.v1.CourseServiceContent
pulse.v1.PublishingServiceContent
pulse.v1.CampaignServiceCampaigns and results
pulse.v1.MetricsServiceCampaigns and results
pulse.v1.AnalyticsServiceCampaigns and results
pulse.v1.FollowUpServiceCampaigns and results
pulse.v1.LeadServiceLeads and accounts
pulse.v1.IntegrationServiceLeads and accounts
pulse.v1.InfluencerServiceLeads and accounts
pulse.v1.ModelServiceAI and platform
pulse.v1.ActivityServiceAI and platform
pulse.v1.IdentityServiceAI and platform
pulse.v1.ConfigServiceAI and platform
pulse.v1.TwinServiceAI and platform
pulse.v1.SelfHealServiceAI and platform
pulse.v1.MeteringService (deprecated)AI and platform
runink.ui.billing.v1.BillingServiceShared components
runink.ui.datasources.v1.ConnectionsService, RunnersServiceShared components
runink.ui.profile.v1.ProfileServiceShared components
runink.ui.access.v1.AccessServiceShared components

Conventions

  • Authentication. Every method needs authorization: Bearer <accessToken>, except IdentityService/Login, ModelService/GetModelStatus, and gRPC reflection.
  • Scoping. Data is scoped to the signed-in user. Request fields named user_id (for example in GetConfigRequest and ListIntegrationsRequest) do not let you read another user’s data.
  • Streaming. AI generators return stream StreamChunk. See Common types.
  • Pagination. List methods that paginate take PaginationRequest and return PaginationResponse.
  • Errors. Standard gRPC status codes with a human-readable message. See Troubleshooting.