Create a widget
POST/v2/spaces/:space_id/widgets
Adds a widget for an object to the space sidebar (scope space, owner and admins) or to this account's own (scope personal, any member who can write). One widget per target per scope. The layout and limit follow the app's own rules: a layout the target cannot render, or a limit off the app's list, is replaced with the app's fallback and reported in warnings.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 413
- 429
Dry run; validation result without committing
The widget as stored
Validation failure: the target is missing, archived, a property, a template or a built-in listing, or the sidebar already holds it
Missing, unknown, revoked or expired key; shared authentication envelope
The shared key-scope gate uses the legacy envelope; an operation-specific refusal may use the v2 error envelope
The space does not exist, or is not available (deleted, left, or still joining)
Idempotency-Key conflict, or an operation-specific concurrency conflict
Request body exceeds this operation's documented cap
Shared write rate limit; legacy error envelope