Generate a personality proposal from a natural-language description
POST/v1/personalities/from-guided-prompt
Guided prompting (SPEC-13 §4.5, SPEC-16 §9; SDK: fromGuidedPrompt). Translates a natural-language description into a structured personality proposal for the developer to review — NOTHING is persisted by this call. Accept the proposal with POST /v1/personalities, passing the proposal body plus source='guided_prompt', source_ref=<original description>, and the confirmed sensitivity declaration (the critical_questions are never auto-answered). Iterate by resending with refine (previous proposal + change instructions). Descriptions that violate the acceptable-use policy return 422 guided_prompt_policy_violation; descriptions too vague to work with return status='needs_clarification'. Generation cost is absorbed by uniqOS — this call never consumes turns.
Request
Responses
- 200
- 400
- 401
- 403
- 409
- 422
- 429
- 500
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Requests-per-second ceiling for the current bucket (per-organization for authenticated calls, per-IP for public ones).
Tokens left in the bucket after this request.
ISO-8601 timestamp when the bucket will be fully refilled.
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Turns consumed by the organization in the current billing period.
Turn ceiling for the organization in the current billing period.
Active relationships currently counted toward the organization’s quota.
Active-relationship ceiling for the organization’s plan.
ISO-8601 timestamp when the current billing period (and the quota) rolls over.
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).
Requests-per-second ceiling for the current bucket (per-organization for authenticated calls, per-IP for public ones).
Tokens left in the bucket after this request.
ISO-8601 timestamp when the bucket will be fully refilled.
Seconds the client should wait before retrying. Emitted only on 429 responses.
Turns consumed by the organization in the current billing period.
Turn ceiling for the organization in the current billing period.
Active relationships currently counted toward the organization’s quota.
Active-relationship ceiling for the organization’s plan.
ISO-8601 timestamp when the current billing period (and the quota) rolls over.
Default Response
Response Headers
ULID stamped on every response and propagated through error envelopes. Use it when filing support tickets — it identifies the exact request in the structured logs (requestId field).