How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Goalkeeper API

Open-source (Apache-2.0) REST API for Goalkeeper, Poggio Labs' durable-goals record for teams of people and AI agents. 36 operations across goals, append-only goal updates, labels, organizations, API tokens and authentication, described by a published OpenAPI 3.1.0 document. Self-hosted: Poggio Labs runs no hosted instance, so the only declared server is the local development host and operators supply their own. Writes are idempotency-keyed and revision-checked.

This API exposes 36 operations across 25 paths, organized into 5 resource areas, and defines 58 schemas. It is described by OpenAPI 3.1.0, at version 0.0.0.

Requests are made against a single base URL, http://localhost:3001.

36 operations 25 paths 58 schemas 4 DELETE15 GET4 PATCH13 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.0.0
Base URL
http://localhost:3001
Authentication
HTTP Bearer, API Key
Resource Areas
5

Authentication & Security 2

Goalkeeper API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). An API key is passed in the cookie as goalkeeper_session (cookieAuth).

  • bearerAuth — A Goalkeeper API token or provider-issued OAuth access token.

Paths & Operations 36

Across 25 paths, the API surfaces 36 operations — 4 DELETE, 15 GET, 4 PATCH, 13 POST. They span 5 resource areas: System, Authentication, Organizations, API Tokens, Goals. Each is listed below with its method, path, parameters, and response codes.

System 1

Service status endpoints.

GET
/health
Get REST API health
getApiHealth → 200
Authentication 8

User session lifecycle.

GET
/v1/auth/session
Get the current session
getAuthSession → 200401
GET
/v1/auth/config
Get authentication configuration
getAuthConfiguration → 200
GET
/v1/auth/login
Begin login
beginAuthLogin 1 param → 302
POST
/v1/auth/login
Sign in with email
loginWithEmail body → 200400401403
POST
/v1/auth/register
Register with email
registerWithEmail body → 202400403
POST
/v1/auth/verify-email
Verify an email principal
verifyEmail body → 200400403
GET
/v1/auth/callback
Complete login
completeAuthLogin 1 param → 302
POST
/v1/auth/logout
Log out
logoutAuthSession → 200403
Organizations 11

Organization membership and active organization selection.

GET
/v1/organizations
List organizations
listOrganizations → 200401
POST
/v1/organizations
Create an organization
createOrganization body → 201400401403
POST
/v1/organizations/switch
Switch organizations
switchOrganization body → 200400401403
PATCH
/v1/organizations/current
Update the active organization
updateCurrentOrganization body → 200400401403
GET
/v1/organizations/current/members
List active organization members
listCurrentOrganizationMembers → 200401403
PATCH
/v1/organizations/current/members/{userId}
Update an organization member role
updateCurrentOrganizationMemberRole 1 param body → 200400401403
GET
/v1/organizations/current/invitations
List pending invitations
listCurrentOrganizationInvitations → 200401403
POST
/v1/organizations/current/invitations
Invite someone to the active organization
createCurrentOrganizationInvitation body → 201400401403409
DELETE
/v1/organizations/current/invitations/{invitationId}
Revoke a pending invitation
revokeCurrentOrganizationInvitation 1 param → 204400401403
POST
/v1/organizations/current/invitations/{invitationId}/resend
Reissue a pending invitation
resendCurrentOrganizationInvitation 1 param → 200400401403
POST
/v1/organizations/invitations/accept
Accept an invitation
acceptOrganizationInvitation body → 200400401403404409
API Tokens 4

Scoped credentials owned by an organization and user.

GET
/v1/api-tokens
List API tokens
listApiTokens → 200401
POST
/v1/api-tokens
Create an API token
createApiToken body → 201400401403
GET
/v1/api-token-scopes
List API token scopes
listApiTokenScopes → 200
DELETE
/v1/api-tokens/{tokenId}
Revoke an API token
revokeApiToken 1 param → 200401403404
Goals 12

Organization goals and their label taxonomy.

GET
/v1/goals
List goals
listGoals 4 params → 200400401403404409
POST
/v1/goals
Publish a goal
createGoal body → 201400401403404409
GET
/v1/goals/{goalId}
Get a goal
getGoal 1 param → 200400401403404409
PATCH
/v1/goals/{goalId}
Update goal metadata
updateGoal 1 param body → 200400401403404409
DELETE
/v1/goals/{goalId}
Delete a goal
deleteGoal 1 param → 204400401403404409
GET
/v1/goals/{goalId}/updates
List goal updates
listGoalUpdates 1 param → 200400401403404409
POST
/v1/goals/{goalId}/updates
Report a goal update
createGoalUpdate 1 param body → 201400401403404409
GET
/v1/goal-labels
List goal labels
listGoalLabels → 200400401403404409
POST
/v1/goal-labels
Create a goal label
createGoalLabel body → 201400401403404409
GET
/v1/goal-labels/{labelId}
Get a goal label
getGoalLabel 1 param → 200400401403404409
PATCH
/v1/goal-labels/{labelId}
Update a goal label
updateGoalLabel 1 param body → 200400401403404409
DELETE
/v1/goal-labels/{labelId}
Delete an unused goal label
deleteGoalLabel 1 param → 204400401403404409

Schemas 58

The contract defines 58 schemas that model the data the API accepts and returns. The most detailed are Goal (16 properties), GoalUpdate (15 properties), GoalLabel (9 properties), ApiToken (8 properties). Each schema is shown below with its type and property counts.

AuthConfiguration
object
1 property 1 required
EmailLoginRequest
object
3 properties 3 required
EmailRegistrationRequest
object
3 properties 3 required
EmailRegistrationResponse
object
2 properties 2 required
EmailVerificationRequest
object
1 property 1 required
ApiTokenScope
string
OrganizationRole
string
OrganizationSummary
object
3 properties 3 required
OrganizationContext
object
2 properties 2 required
CreateOrganizationRequest
object
1 property 1 required
SwitchOrganizationRequest
object
1 property 1 required
UpdateOrganizationRequest
object
1 property 1 required
OrganizationMember
object
4 properties 4 required
ListOrganizationMembersResponse
object
1 property 1 required
InvitableOrganizationRole
string
OrganizationInvitation
object
7 properties 7 required
ListOrganizationInvitationsResponse
object
1 property 1 required
CreateOrganizationInvitationRequest
object
2 properties 2 required
IssuedOrganizationInvitation
object
3 properties 3 required
AcceptOrganizationInvitationRequest
object
1 property 1 required
AcceptOrganizationInvitationResponse
object
4 properties 4 required
UpdateOrganizationMemberRoleRequest
object
1 property 1 required
UpdateOrganizationMemberRoleResponse
object
1 property 1 required
GoalStatus
string
GoalHealth
string
GoalTimeframe
PublishedGoalTimeframe
GoalEvaluationResult
string
GoalEvaluation
object
2 properties 2 required
GoalCriterion
object
2 properties 2 required
GoalLabel
object
9 properties 9 required
Goal
object
16 properties 16 required
GoalResponse
object
1 property 1 required
ListGoalsResponse
object
1 property 1 required
CreateGoalRequest
object
6 properties 2 required
UpdateGoalRequest
object
6 properties
GoalActor
GoalAuthentication
object
2 properties 2 required
GoalClientInfo
object
2 properties 2 required
GoalUpdate
object
15 properties 15 required
GoalUpdateResponse
object
1 property 1 required
ListGoalUpdatesResponse
object
1 property 1 required
CreateGoalUpdateRequest
object
7 properties 5 required
GoalLabelResponse
object
1 property 1 required
ListGoalLabelsResponse
object
1 property 1 required
CreateGoalLabelRequest
object
3 properties 1 required
UpdateGoalLabelRequest
object
3 properties
ApiTokenScopeDefinition
object
4 properties 4 required
ListApiTokenScopesResponse
object
1 property 1 required
ApiToken
object
8 properties 8 required
ListApiTokensResponse
object
1 property 1 required
CreateApiTokenRequest
object
3 properties 2 required
CreateApiTokenResponse
object
2 properties 2 required
RevokeApiTokenResponse
object
1 property 1 required
AuthUser
object
3 properties 3 required
AuthSession
object
3 properties 3 required
AuthTransitionResponse
object
1 property 1 required
Error
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

poggio-labs-goalkeeper-openapi.json Raw ↑
Where this information came from

This is an independent, third-party profile of Goalkeeper API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.