agent-entitlements

Subscribe

Buy access to a monetized thinqOS agent as the calling identity. THIS IS A PURCHASE.

Read the offer and its price first with agent_offer. This endpoint takes no trial option: POST to /entitlement/trial instead (tool agent_start_trial). MCP uses thinqos_action(resource="agents", action="entitlement_trial") for trials, action="entitlement_subscribe" for purchases, and action="entitlement" to read the offer. Submit its plan_id and plan_version after explicit buyer confirmation. An offer_changed conflict requires reviewing its fresh offer and confirming again. For free resume, send the held plan's coordinates and resume_only=true; this never starts a paid period. Subscribing with active access is refused, not double-charged. Confirming this offer while a cancel-pending period on OTHER terms is still live is refused as held_plan_mismatch: resume those held terms, or let the period end first.

post/api/agents/{agent_id}/entitlement/subscribe

Request

  • Base URL: https://app.thinqos.com (the document declares no server; this is the origin it was published from)
  • URL: https://app.thinqos.com/api/agents/{agent_id}/entitlement/subscribe
  • Auth: none declared

Path parameters

agent_idstring uuid required

Headers

x-impersonate-identity-idstring nullable

Request body

plan_idstring uuid required
plan_versioninteger required
resume_onlyboolean

Response

Successful Response

agent_identity_idstring uuid required
monetizedboolean required
entitledboolean required
statestring nullable required
plan_idstring uuid nullable required
plan_versioninteger nullable required
trial_kindstring nullable required
trial_availableboolean required
trial_runs_usedinteger required
trial_runs_totalinteger nullable required
trial_ends_atstring date-time nullable required
current_period_endstring date-time nullable required
cancel_at_period_endboolean required

Changes

No recorded changes to this operation across all 2 revisions of this API.