Read the org's Profile — its legible taste
One read for everything the platform knows about this org's taste: brand kits, registered critics (the machine-checkable standard both the Director's gates and score_composition enforce), the critics' reference media with presigned thumbnails, and the recent checkpoint-decision log (what was approved/revised/abandoned, where). Read this before composing for an org you haven't worked with — it is the house style.
API key auth. Prefix cf_live_ for production orgs, cf_test_ for sandbox.
In: header
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/profile"{ "brandKits": [ { "id": "string", "name": "string" } ], "critics": [ { "criticId": "string", "label": "string", "tier": "rules", "phase": "static", "floor": 0, "referenceMediaIds": [ "string" ] } ], "references": [ { "mediaId": "string", "name": "string", "thumbnailUrl": "string" } ], "recentDecisions": [ { "checkpointId": "string", "projectId": "string", "kind": "gate", "stage": "content", "decision": "string", "decidedAt": 0 } ]}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}Return the caller's account: identity, plan, entitlements, cost ceilings GET
Returns the org this key is bound to (server-resolved from auth, never the body), the current plan/tier, a per-feature `entitlements` map (included? + remaining/limit for metered features), and `costCeilings` (e.g. the generate_media per-call USD ceiling). Read it BEFORE a metered call (create_render / compose / generate_media / create_brand_kit) to budget without burning a round-trip on a 402. Plan/entitlement values come from the billing backend best-effort; unknown values are `null` and `billingConfigured:false` flags an environment where billing isn't configured.
Create a scoped API key (session credential only) POST
Next Page