Can our team create its own account and API key?
Yes. Sign up at app.apiosk.com/signup, choose a team account, and confirm your email. The owner or an admin can then open Organisation → API keys to create a key with permissions and spending limits. Keep the secret on your server; it is displayed once.Do API calls need a key?
The buyer API in these docs uses an organisation key sent asAuthorization: Bearer apk_org_live_…. Browse sources with
GET /v2/sources, inspect executable operations with
GET /v2/sources/, and use Ask when the
source is not known. The hosted MCP server uses a person’s
account connection instead of an organisation API key.
Does seeing a source mean every endpoint is ready to buy?
No. The directory includes entries that are still discovery-only or restricted. Checkavailable_in_v2, readiness, and
executable_capabilities; then read one source for the currently
executable operations, exact inputs, and prices. Do not infer availability
from a source name or its raw endpoint count.
When does a question cost money?
Browsing and planning are free. A purchase starts only after the plan is authorized within its displayed total ceiling. The result includes actual charges, any amount still held, and source references. See Prices and balance.What if the question needs more context?
An Ask response can returnneeds_input with a clarifying
message, or needs_selection with candidates. Ask
the person for the missing fact or the right entity. In the app or MCP card,
continue the saved task using its offered action. In the buyer HTTP API,
submit a new clarified question; it has no input-continuation endpoint.
What if a run takes longer than the request timeout?
HTTP 202 includes the run id. ReadGET /v2/runs/ to resume
from the saved state. Retry a paid request with the same
Idempotency-Key.