chore: update openapi specs for deficarrot,defituna lulo,marginfi#46
chore: update openapi specs for deficarrot,defituna lulo,marginfi#46github-actions[bot] wants to merge 1 commit intomainfrom
Conversation
There was a problem hiding this comment.
Spec changes
1. New endpoints
No new endpoint paths or HTTP methods were added across the updated specs:
openapi/deficarrot.jsonopenapi/defituna.jsonopenapi/lulo.jsonopenapi/marginfi.json
2. Deprecated or removed fields/endpoints
No deprecated: true flags were added or removed, and no endpoints were removed.
Removed fields/examples observed:
deficarrot: removed request body named examples for mint/redeem POST responses.deficarrot+marginfi: removed some parameterschema.examplesarrays in favor ofexample/defaultusage.defituna: removed emptycomponents.schemasblock (structural cleanup only).defituna+marginfi: replacedschema.x-examplewith standardschema.example.
3. New or modified parameters (required vs optional)
No required/optional flag changes were detected for parameters.
Modified parameters:
deficarrot(/v0/crt/mint/{poolToken},/v0/crt/redeem/{poolToken}):poolTokendefault/example changed fromUSDCtoPYUSDon POST endpoints, and default/example now explicitly present on GET endpoints.
defituna(/v0/lend/{poolToken}/deposit|withdraw):- parameter examples normalized to standard
example. percentagemetadata now includes explicitx-defaultandexampleon POST endpoints.
- parameter examples normalized to standard
marginfi(/v0/lend/{tokenSymbol}/deposit|withdrawPOST):- parameter serialization metadata changed (
style/exploderemoved,allowEmptyValue/allowReservedadded). - added/normalized
example+x-defaulton percentage-like params.
- parameter serialization metadata changed (
4. Schema/type changes
Most significant behavioral schema changes are in defituna:
- GET responses (
deposit+withdraw):links.actions[].typechanged from a fixedconst: "transaction"toenum: ["transaction", "external-link"].
- POST responses (
deposit+withdraw):- added
links.nextobject shape (type,href) anddialectExperimental.referencefields.
- added
Additional structural metadata changes:
- operation IDs are now protocol-namespaced in all 4 specs (e.g.,
defituna.v0...,marginfi.v0..., etc.). x-mint.hrefwas added on operations to pin API reference routes.
5. Description updates
deficarrotoperation summaries were simplified:Get mint blink->MintMint operation->MintGet redeem blink->RedeemRedeem operation->Redeem
defitunainfo title changed:DeFiTuna Blinks->Defituna Blinks API
Documentation that may now be outdated
I searched .mdx files for changed identifiers/paths and found the following likely review targets.
- API reference link targets likely stale after route namespacing (
x-mint.hrefadditions)
release-notes/index.mdx- This file still references legacy paths like
/api-reference/mint/get-mint-blinkand/api-reference/lend/lend-deposit, while specs now explicitly annotate namespaced routes such as:api-reference/deficarrot/earn/mint-getapi-reference/defituna/lend/deposit-getapi-reference/lulo/deposit/deposit-getapi-reference/marginfi/lend/deposit-get
- Client integration docs that currently model action buttons as transaction-only
standard-blinks-library/quick-start.mdxblinks/blinks-client/integrate/headless/index.mdx- Both heavily show
links.actions[].type: "transaction"and do not clearly call out the newexternal-linkpossibility now present in updated DeFiTuna GET response schema.
- Chaining/response-shape docs to validate against new POST response shape
standard-blinks-library/quick-start.mdxblinks/blinks-client/integrate/headless/index.mdxblinks/blinks-provider/advanced/action-chaining.mdx- DeFiTuna POST responses now include
links.next+dialectExperimentalfields; worth aligning consumer-oriented examples and expectations.
Deprecations (high priority)
No explicit deprecations were introduced in this PR:
- no new deprecated endpoints
- no newly deprecated fields
- no removals marked as deprecation migrations
High-priority note anyway: because links.actions[].type expanded (transaction + external-link), consumer assumptions may break even without formal deprecations.
Suggested action items for DevRel
- Validate and update stale API reference links in
release-notes/index.mdxto current namespaced routes emitted byx-mint.href. - Update client-facing integration docs (
standard-blinks-library/quick-start.mdx,blinks/blinks-client/integrate/headless/index.mdx) to explicitly handlelinks.actions[].type = "external-link". - Add a short compatibility note/changelog callout that some protocol GET action schemas are no longer transaction-only.
- Add a note in protocol docs that DeFiCarrot
poolTokendefault shifted toPYUSD(important for copy/paste tests and examples). - Re-test code examples that parse POST responses as only
{ type, transaction }and ensure they tolerate optionallinks.next/dialectExperimentaladditions.
Sent by Cursor Automation: PR Summary Bot


Automated daily sync of OpenAPI specs from live APIs.
Review the diff and merge when ready — Mintlify will rebuild automatically.