Developer & Agent Resources

Public API and OAuth documentation

Workforce Infotech publishes a read-only service catalog, status endpoint, OpenAPI description, OAuth metadata and a protected capability endpoint for automated discovery.

Public endpoints

GET /api/v1/services returns the six service categories and their official landing pages.

GET /api/v1/status returns the current discovery-service status.

GET /.well-known/api-catalog returns an RFC 9727 JSON Linkset.

OAuth client-credentials flow

  1. POST JSON with client_name to /oauth/register.
  2. Store the returned client ID and secret securely.
  3. POST grant_type=client_credentials&scope=agent.read to /oauth/token using HTTP Basic authentication.
  4. Call /api/v1/private-capabilities with the bearer token.
  5. Revoke the token through /oauth/revoke when it is no longer needed.

The protected endpoint only returns integration links. It does not expose customer records, accept payments or submit project enquiries.