Skip to content

docs(readiness): declare account operations, grpc calls, body keys and new companies - #394

Merged
auscaster merged 3 commits into
mainfrom
docs/account-operations
Oct 14, 2026
Merged

auscaster merged 3 commits into
mainfrom
docs/account-operations

Conversation

@auscaster

@auscaster auscaster commented Oct 13, 2026 •

Copy link
Copy Markdown
Member

CONTRIBUTING documents three declaration features the readiness engine already reads. Live listings use each of them.

Account operations (north star §5.6). Frantic and Telnyx declare them.

  • An account_operations entry declares a sign-up API (registration), or a top-up the agent pays itself (top_up), on an interface's own endpoint. Its spec is the vendor's OpenAPI 3 document.
  • Sourcey sends nothing to one. It reads the operation in the spec, following references on the same host.
  • A registration endpoint is now the page where a person signs up, requested only to see that it is there.
  • A sign-up the spec says needs no credential is an agent registration path. It counts only with an empty requirement, or with none in a document that requires one on its other operations.

A gRPC call and a key in the request body. Modal and Amplitude use these.

  • { media_type: application/grpc } declares a gRPC call: a POST to the method's path.
  • credential_field names the body field a vendor takes its key in. OpenAPI has no security scheme for a key in the body.

A company new to Sourcey, listed in the same pull request as its declaration.

This folds in #356 and #359, which edit the same file, so the three land in one review. #359's GraphQL wording is left out: #377 already landed it.

@sourcey

sourcey Bot commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

A maintainer will review your pull request

Sourcey can't admit this change automatically, so a maintainer reviews it. You don't need to do anything.

Follow your pull request on Sourcey

! A maintainer reviews this change.

  • The pull request changes more than the repository's data or one declared pin.

@auscaster
auscaster force-pushed the docs/account-operations branch from b4ca899 to 2934830 Compare October 14, 2026 01:26
@auscaster auscaster changed the title docs: declare sign-up APIs and paid top-ups as account operations docs(readiness): declare account operations, grpc calls, body keys and new companies Oct 14, 2026
@sourcey

sourcey Bot commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

A maintainer will review your pull request

Sourcey can't admit this change automatically, so a maintainer reviews it. You don't need to do anything.

Follow your pull request on Sourcey

! A maintainer reviews this change.

  • The pull request changes more than the repository's data or one declared pin.

@auscaster
auscaster merged commit 5f09c92 into main Oct 14, 2026
3 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant